ProjectEditor Class Reference

The ProjectEditor class. More...

#include <projecteditor.h>

Inherits QObject.

Collaboration diagram for ProjectEditor:

Public Slots
void	showAllRequiredEditors () noexcept
	Open the schematic and/or the board editor window. More...
void	showSchematicEditor () noexcept
	Open the schematic editor window and bring it to the front. More...
void	showBoardEditor () noexcept
	Open the board editor window and bring it to the front. More...
void	execProjectSettingsDialog (QWidget *parent=nullptr) noexcept
	Execute the project settings dialog (blocking!) More...
void	execNetClassesEditorDialog (QWidget *parent=nullptr) noexcept
	Execute the netclasses editor dialog (blocking!) More...
void	execLppzExportDialog (QWidget *parent=nullptr) noexcept
	Execute the *.lppz export dialog (blocking!) More...
bool	saveProject () noexcept
	Save the whole project to the harddisc. More...
bool	autosaveProject () noexcept
	Make a automatic backup of the project (save to temporary files) More...
bool	closeAndDestroy (bool askForSave, QWidget *msgBoxParent=0) noexcept
	Close the project (this will destroy this object!) More...

Signals
void	showControlPanelClicked ()
void	openProjectLibraryUpdaterClicked (const FilePath &fp)
void	projectEditorClosed ()

Public Member Functions
	ProjectEditor ()=delete
	ProjectEditor (const Project &other)=delete
	ProjectEditor (workspace::Workspace &workspace, Project &project)
	The constructor. More...
	~ProjectEditor () noexcept
	The destructor. More...
workspace::Workspace &	getWorkspace () const noexcept
Project &	getProject () const noexcept
const LengthUnit &	getDefaultLengthUnit () const noexcept
UndoStack &	getUndoStack () const noexcept
	Get a reference to the undo stack of the project. More...
bool	windowIsAboutToClose (QMainWindow &window) noexcept
	Inform the editor that a project related window is about to close. More...
ProjectEditor &	operator= (const Project &rhs)=delete

Private Member Functions
int	getCountOfVisibleEditorWindows () const noexcept

Private Attributes
workspace::Workspace &	mWorkspace
Project &	mProject
QTimer	mAutoSaveTimer
UndoStack *	mUndoStack
	See The undo/redo system (Command Design Pattern). More...
SchematicEditor *	mSchematicEditor
	The schematic editor (GUI) More...
BoardEditor *	mBoardEditor
	The board editor (GUI) More...
uint	mLastAutosaveStateId

Detailed Description

The ProjectEditor class.

Constructor & Destructor Documentation

ProjectEditor() [1/3]

ProjectEditor ( )

delete

ProjectEditor() [2/3]

ProjectEditor ( const Project &  other )

delete

ProjectEditor() [3/3]

ProjectEditor	(	workspace::Workspace &	workspace,
		Project &	project
	)

The constructor.

Here is the call graph for this function:

~ProjectEditor()

~ProjectEditor ( )

noexcept

The destructor.

Here is the call graph for this function:

Member Function Documentation

getWorkspace()

workspace::Workspace& getWorkspace ( ) const

inlinenoexcept

Here is the caller graph for this function:

getProject()

Project& getProject ( ) const

inlinenoexcept

Here is the caller graph for this function:

getDefaultLengthUnit()

const LengthUnit & getDefaultLengthUnit ( ) const

noexcept

Here is the call graph for this function:

Here is the caller graph for this function:

getUndoStack()

UndoStack& getUndoStack ( ) const

inlinenoexcept

Get a reference to the undo stack of the project.

Returns

A reference to the UndoStack object

Here is the caller graph for this function:

windowIsAboutToClose()

bool windowIsAboutToClose ( QMainWindow &  window )

noexcept

Inform the editor that a project related window is about to close.

The project must be closed and destroyed automatically after the last opened window of the project is closed, because without a window the user is no longer able to close the project himself. So, every project related window have to "ask" the librepcb::project::editor::ProjectEditor object whether it is allowed to close or not. If the last opened window wants to close, the editor will first ask the user if unsaved changes should be written to the harddisc. Only if the user accepts this question and the project is saved successfully, the method will return true to allow the last window to close. Then it will also close the whole project.

Parameters

window

A reference to the window which is about to close

Returns

true if the window can be closed, false if closing the window is denied

Here is the call graph for this function:

Here is the caller graph for this function:

operator=()

ProjectEditor& operator= ( const Project &  rhs )

delete

showAllRequiredEditors

void showAllRequiredEditors ( )

slotnoexcept

Open the schematic and/or the board editor window.

Which editors this will open depends on whether the project has schematics and/or boards. If there aren't any boards or schematics, the schematic editor will be shown anyway (otherwise the whole project editor would be invisible).

Here is the call graph for this function:

Here is the caller graph for this function:

showSchematicEditor

void showSchematicEditor ( )

slotnoexcept

Open the schematic editor window and bring it to the front.

Here is the caller graph for this function:

showBoardEditor

void showBoardEditor ( )

slotnoexcept

Open the board editor window and bring it to the front.

Here is the caller graph for this function:

execProjectSettingsDialog

void execProjectSettingsDialog ( QWidget *  parent = nullptr )

slotnoexcept

Execute the project settings dialog (blocking!)

Parameters

parent

parent widget of the settings dialog (optional)

Here is the call graph for this function:

execNetClassesEditorDialog

void execNetClassesEditorDialog ( QWidget *  parent = nullptr )

slotnoexcept

Execute the netclasses editor dialog (blocking!)

Parameters

parent

parent widget of the dialog (optional)

Here is the call graph for this function:

execLppzExportDialog

void execLppzExportDialog ( QWidget *  parent = nullptr )

slotnoexcept

Execute the *.lppz export dialog (blocking!)

Parameters

parent

parent widget of the dialog (optional)

Here is the call graph for this function:

saveProject

bool saveProject ( )

slotnoexcept

Save the whole project to the harddisc.

Note

The whole save procedere is described in Atomic Saving Procedure.

Returns

true on success, false on failure

Here is the call graph for this function:

Here is the caller graph for this function:

autosaveProject

bool autosaveProject ( )

slotnoexcept

Make a automatic backup of the project (save to temporary files)

Note

The whole save procedere is described in Atomic Saving Procedure.

Returns

true on success, false on failure

Here is the call graph for this function:

Here is the caller graph for this function:

closeAndDestroy

bool closeAndDestroy ( bool  askForSave, QWidget *  msgBoxParent = 0  )

slotnoexcept

Close the project (this will destroy this object!)

If there are unsaved changes to the project, this method will ask the user whether the changes should be saved or not. If the user clicks on "cancel" or the project could not be saved successfully, this method will return false. If there was no such error, this method will call QObject::deleteLater() which means that this object will be deleted in the Qt's event loop.

Warning

This method can be called both from within this class and from outside this class (for example from the librepcb::application::ControlPanel). But if you call this method from outside this class, you may have to delete the object yourself afterwards! In special cases, the deleteLater() mechanism could lead in fatal errors otherwise!

Parameters

askForSave	If true and there are unsaved changes, this method shows a message box to ask whether the project should be saved or not. If false, the project will NOT be saved.
msgBoxParent	Here you can specify a parent window for the message box

Returns

true on success (project closed), false on failure (project stays open)

Here is the call graph for this function:

Here is the caller graph for this function:

showControlPanelClicked

void showControlPanelClicked ( )

signal

Here is the caller graph for this function:

openProjectLibraryUpdaterClicked

void openProjectLibraryUpdaterClicked ( const FilePath &  fp )

signal

Here is the caller graph for this function:

projectEditorClosed

void projectEditorClosed ( )

signal

Here is the caller graph for this function:

getCountOfVisibleEditorWindows()

int getCountOfVisibleEditorWindows ( ) const

privatenoexcept

Here is the caller graph for this function:

Member Data Documentation

mWorkspace

workspace::Workspace& mWorkspace

private

mProject

Project& mProject

private

mAutoSaveTimer

QTimer mAutoSaveTimer

private

the timer for the periodically automatic saving functionality (see also Atomic Saving Procedure)

mUndoStack

UndoStack* mUndoStack

private

See The undo/redo system (Command Design Pattern).

mSchematicEditor

SchematicEditor* mSchematicEditor

private

The schematic editor (GUI)

mBoardEditor

BoardEditor* mBoardEditor

private

The board editor (GUI)

mLastAutosaveStateId

uint mLastAutosaveStateId

private

The UndoStack state ID of the last successful project (auto)save

---

The documentation for this class was generated from the following files:

• /__w/1/s/libs/librepcb/projecteditor/projecteditor.h
• /__w/1/s/libs/librepcb/projecteditor/projecteditor.cpp