X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FXGUI%2FXGUI_OperationMgr.h;h=4c3a4d78484ccee0eefa4232c6085f3b758b9c8d;hb=fc72d43b677baa05ae7fd317346fd8b723b799ed;hp=eb0e7541a753675a929521bc09d0342576d81937;hpb=fb1766a3fb7d2b3e6862e040d528d96a5732f200;p=modules%2Fshaper.git diff --git a/src/XGUI/XGUI_OperationMgr.h b/src/XGUI/XGUI_OperationMgr.h index eb0e7541a..4c3a4d784 100644 --- a/src/XGUI/XGUI_OperationMgr.h +++ b/src/XGUI/XGUI_OperationMgr.h @@ -1,8 +1,21 @@ -// Copyright (C) 2014-20xx CEA/DEN, EDF R&D --> - -// File: XGUI_OperationMgr.h -// Created: 20 Apr 2014 -// Author: Natalia ERMOLAEVA +// Copyright (C) 2014-2023 CEA/DEN, EDF R&D +// +// This library is free software; you can redistribute it and/or +// modify it under the terms of the GNU Lesser General Public +// License as published by the Free Software Foundation; either +// version 2.1 of the License, or (at your option) any later version. +// +// This library is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +// Lesser General Public License for more details. +// +// You should have received a copy of the GNU Lesser General Public +// License along with this library; if not, write to the Free Software +// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +// +// See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com +// #ifndef XGUI_OperationMgr_H #define XGUI_OperationMgr_H @@ -10,12 +23,18 @@ #include "XGUI.h" #include +#include "ModelAPI_Feature.h" #include #include #include class QKeyEvent; +class QMessageBox; + +class ModuleBase_IWorkshop; +class XGUI_Workshop; +class XGUI_ShortCutListener; /**\class XGUI_OperationMgr * \ingroup GUI @@ -29,13 +48,39 @@ class QKeyEvent; class XGUI_EXPORT XGUI_OperationMgr : public QObject { Q_OBJECT - public: +public: + /// Enumeration of kind of message that is used when trying to stop the active operation + enum XGUI_MessageKind + { + XGUI_AbortOperationMessage, ///< warns and give possibility to abort current operation + XGUI_InformationMessage ///< ask to apply the current operation before performing something + }; + +public: /// Constructor /// \param theParent the parent - XGUI_OperationMgr(QObject* theParent); + /// \param theWorkshop a reference to workshop + XGUI_OperationMgr(QObject* theParent, ModuleBase_IWorkshop* theWorkshop); + /// Destructor virtual ~XGUI_OperationMgr(); + /// Switch on short cut listener + void activate(); + /// Switch off short cut listener + void deactivate(); + + /// Set reference to workshop + /// \param theWorkshop reference to workshop + void setWorkshop(ModuleBase_IWorkshop* theWorkshop) + { myWorkshop = theWorkshop; }; + + /// Current workshop + ModuleBase_IWorkshop* workshop() const { return myWorkshop; } + + /// Current workshop + XGUI_Workshop* xworkshop() const; + /// Returns the current operation or NULL /// \return the current operation ModuleBase_Operation* currentOperation() const; @@ -50,8 +95,12 @@ Q_OBJECT /// Returns true is operation manager has an operation with given Id. bool hasOperation(const QString& theId) const; - /// Returns true if the operation can be aborted - bool canStopOperation(); + /// Returns true if the operation can be aborted. If the operation is modified, + /// the warning message box is shown. + /// \param theOperation an operation which is checked on stop + /// \param theMessageKind a kind of message in warning message box + bool canStopOperation(ModuleBase_Operation* theOperation, + const XGUI_MessageKind& theMessageKind = XGUI_AbortOperationMessage); /// Find and return operation by its Id. ModuleBase_Operation* findOperation(const QString& theId) const; @@ -66,8 +115,9 @@ Q_OBJECT /// else, or if there is no parent - returns NULL ModuleBase_Operation* previousOperation(ModuleBase_Operation* theOperation) const; - /// Redefinition of virtual function - virtual bool eventFilter(QObject *theObject, QEvent *theEvent); + /// Returns an active widget of the current operation. + /// \return widget or NULL + ModuleBase_ModelWidget* activeWidget() const; /// Start the operation and append it to the stack of operations /// \param theOperation the started operation @@ -77,39 +127,46 @@ Q_OBJECT /// Returns whether the operation can be started. Check if there is already started operation and /// the granted parameter of the launched operation /// \param theId id of the operation which is going to start - bool canStartOperation(QString theId); + /// \param isCommitted boolean value if the operation was committed otherwise it was aborted + bool canStartOperation(const QString& theId, bool& isCommitted); + + /// If Apply is enabled and operation has modification, it is applyed, otherwise aborted + /// \param theOperation the started operation + /// \param isCommitted boolean value if the operation was committed otherwise it was aborted + void stopOperation(ModuleBase_Operation* theOperation, bool& isCommitted); + + /// Aborts the parameter operation if it is current, else abort operations from the stack + /// of operations until the operation is found. All operations upper the parameter one are + /// not aborted. + /// \param theOperation an aborted operation + void abortOperation(ModuleBase_Operation* theOperation); - /// Blocking/unblocking enabling of Ok button in property panel. - /// It is used when operation can not be validated even all attributes are valid - void setLockValidating(bool toLock) { myIsValidationLock = toLock; } + /// Abort all operations + /// \param theMessageKind kind of shown warning message + bool abortAllOperations(const XGUI_MessageKind& theMessageKind = XGUI_AbortOperationMessage); - /// Returns state of validation locking - bool isValidationLocked() const { return myIsValidationLock; } + /// Commits the current operation. + bool commitOperation(); - /// Sets apply state to the value and emit signal about this state is changed - /// \param theEnabled the state value - void setApplyEnabled(const bool theEnabled); + /// Returns true if SHIFT is pressed + /// \param thePressed new boolean state + void setSHIFTPressed(const bool thePressed) { mySHIFTPressed = thePressed; } - /// Returns enable apply state - /// \return theEnabled a boolean value - bool isApplyEnabled() const; + /// Returns true if SHIFT is pressed + /// \return boolean value + bool hasSHIFTPressed() const { return mySHIFTPressed; } - public slots: - /// Slot that commits the current operation. - void onCommitOperation(); +public slots: /// Slot that aborts the current operation. void onAbortOperation(); + /// Slot that aborts all operations. It shows aborting message + void onAbortAllOperation(); /// Slot that validates the current operation using the validateOperation method. void onValidateOperation(); /// Commit all operations bool commitAllOperations(); - /// Abort all operations - bool abortAllOperations(); signals: - /// Signal about an operation is started. It is emitted after the start() of operation is done. - void operationStarted(ModuleBase_Operation* theOperation); - /// Signal about an operation is stopped. It is emitted after the stop() of operation is done. /// \param theOperation a stopped operation void operationStopped(ModuleBase_Operation* theOperation); @@ -123,57 +180,109 @@ signals: /// Emitted when current operation is aborted void operationAborted(ModuleBase_Operation* theOperation); - /// Signal is emitted after the apply enable state changed. - void validationStateChanged(bool); - - /// Signal is emitted after the apply enable state changed. - void nestedStateChanged(bool); - - /// Signal is emitted after the current operation is filled with existing preselection. - void operationActivatedByPreselection(); - /// Signal is emitted after the key released click. void keyEnterReleased(); - protected: - /// Commits the current operatin if it is valid - bool commitOperation(); +public: // TEMPORARY, it should be protected and be performed automatically + /// Emits nestedStateChange for operations with an information about validity of the operation + /// \param theOperation the sent operation. If it is NULL, all operations in the stack are sent. + void updateApplyOfOperations(ModuleBase_Operation* theOperation = 0); +protected: // TEMPORARY /// Sets the current operation or NULL /// \param theOperation the started operation void resumeOperation(ModuleBase_Operation* theOperation); + /// Returns whether the parameter operation is granted in relation to the previous operation + /// in a stack of started operations. It is used in canStopOperation to avoid warning message + /// when granted operation is aborted, e.g. SketchLine in Sketch + /// \param theId id of the operation which is checked + /// \return boolean result + bool isGrantedOperation(const QString& theId); + + /// Sets the feature as a current in the document + /// \param theFeature a feature + void setCurrentFeature(const FeaturePtr& theFeature); + public slots: /// SLOT, that is called by the key in the property panel is clicked. + /// \param theObject a sender of the event /// \param theEvent the mouse event - bool onKeyReleased(QKeyEvent* theEvent); + bool onKeyReleased(QObject *theObject, QKeyEvent* theEvent); + + /// SLOT, that is called by the key in the property panel is clicked. + /// \param theObject a sender of the event + /// \param theEvent the mouse event + bool onKeyPressed(QObject *theObject, QKeyEvent* theEvent); + + /// The functionaly, that should be done by delete click + /// Fistly the active widget processes it, then workshop. If no one does not + /// process it, do nothing + /// \param theObject a sender of the event + bool onProcessDelete(QObject* theObject); protected slots: + /// The functionaly, that should be done by enter click + /// Fistly the active widget processes it, then module. If no one does not + /// process it, the current operation is committed + /// \param theObject a sender of the event + bool onProcessEnter(QObject *theObject); + /// Slot that is called by an operation stop. Removes the stopped operation form the stack. /// If there is a suspended operation, restart it. void onOperationStopped(); - /// Slot called on operation start + /// Slot called before operation started. Stores the previous current feature, set the feature + /// of the operation as a current in the document. The previous current feature should be restored + /// by the operation abort/commit + void onBeforeOperationStarted(); + + /// Slot called after operation started void onOperationStarted(); - /// Slot called on operation abort + /// Slot called before operation aborted. Restore the previous current operation + void onBeforeOperationAborted(); + + /// Slot called after operation aborted void onOperationAborted(); - /// Slot called on operation commit + /// Slot called before operation committed. Restore the previous current operation + void onBeforeOperationCommitted(); + + /// Slot called after operation committed void onOperationCommitted(); /// Slot called on operation resume void onOperationResumed(); +private: + /// Checks if the object is a parent or a child under + /// \param theObject an investivated object + /// \param theParent a candidate to be a parent + static bool isChildObject(const QObject* theObject, const QObject* theParent); + + /// Creates question message box with OK/Cancel buttons, where Cancel is default button, + /// Escape is Null button + /// \param theMessage text of the message + /// \return message box + static QMessageBox* createMessageBox(const QString& theMessage); + + /// Creates information message box with OK button, + /// Escape is Null button + /// \param theMessage text of the message + /// \return message box + static QMessageBox* createInformationBox(const QString& theMessage); + private: typedef QList Operations; ///< definition for a list of operations Operations myOperations; ///< a stack of started operations. The active operation is on top, // others are suspended and started by the active is finished - /// Lock/Unlock access to Ok button in property panel - bool myIsValidationLock; - /// Lock/Unlock access to Ok button in property panel - bool myIsApplyEnabled; + /// Current workshop + ModuleBase_IWorkshop* myWorkshop; + QMessageBox* myActiveMessageBox; + XGUI_ShortCutListener* myShortCutListener; + bool mySHIFTPressed; }; #endif