Salome HOME
#1150 Tab buttons problems
[modules/shaper.git] / src / XGUI / XGUI_PropertyPanel.h
index 071779431999597d0f990657037c22dc8690f43f..a73d896dd31a6cd0cd40cfcb9f0dbb67549f98d8 100644 (file)
 
 #include <QList>
 
+class XGUI_ActionsMgr;
 class QKeyEvent;
-class QVBoxLayout;
+class QGridLayout;
+class ModuleBase_PageBase;
+class ModuleBase_PageWidget;
+class XGUI_OperationMgr;
 
+/// Internal name of property panel widget
 const static char* PROP_PANEL = "property_panel_dock";
+
+/// Internal name of Ok button
 const static char* PROP_PANEL_OK = "property_panel_ok";
+
+/// Internal name of Cancel button
 const static char* PROP_PANEL_CANCEL = "property_panel_cancel";
 
+/// Internal name of Help button
+const static char* PROP_PANEL_HELP = "property_panel_help";
+
+/**
+* \ingroup GUI
+* Realization of Property panel object.
+*/
 class XGUI_EXPORT XGUI_PropertyPanel : public ModuleBase_IPropertyPanel
 {
 Q_OBJECT
  public:
 
+  /// Constructor
+  /// \param theParent is a parent of the property panel
+  /// \param theMgr operation manager
+  XGUI_PropertyPanel(QWidget* theParent, XGUI_OperationMgr* theMgr);
 
-  XGUI_PropertyPanel(QWidget* theParent);
   virtual ~XGUI_PropertyPanel();
 
+  /// Returns header widget
+  virtual QWidget* headerWidget() const { return myHeaderWidget; }
+
   /// Returns main widget of the property panel, which children will be created
   /// by WidgetFactory using the XML definition
-  QWidget* contentWidget();
+  ModuleBase_PageBase* contentWidget();
 
   /// Brings back all widget created by widget factory for signal/slot
   /// connections and further processing
@@ -45,7 +67,7 @@ Q_OBJECT
   virtual const QList<ModuleBase_ModelWidget*>& modelWidgets() const;
 
   /// Removes all widgets in the widget area of the property panel
-  void cleanContent();
+  virtual void cleanContent();
 
   /// Returns currently active widget
   virtual ModuleBase_ModelWidget* activeWidget() const { return myActiveWidget; }
@@ -57,42 +79,85 @@ Q_OBJECT
   /// Activate the next from current widget in the property panel
   virtual void activateNextWidget();
 
-  void setStretchEnabled(bool isEnabled);
-
-  /// Set Enable/Disable state of Ok button
-  virtual void setOkEnabled(bool theEnabled);
-
-  /// Returns state of Ok button
-  virtual bool isOkEnabled() const;
+  /// Set focus on the Ok button
+  virtual void setFocusOnOkButton();
 
-  /// Set Enable/Disable state of Ok button
+  /// Set Enable/Disable state of Cancel button
+  /// \param theEnabled Enable/Disable state of Cancel button
   virtual void setCancelEnabled(bool theEnabled);
 
-  /// Returns state of Ok button
+  /// \return Enable/Disable state of Cancel button
   virtual bool isCancelEnabled() const;
 
- public slots:
+  /// Editing mode depends on mode of current operation. This value is defined by it.
+  /// \param isEditing state of editing mode flag
+  virtual void setEditingMode(bool isEditing);
+
+  //! Allows to set predefined actions for the property panel fetched from the ActionsMgr
+  void setupActions(XGUI_ActionsMgr* theMgr);
+
+  /// Returns widget processed by preselection
+  virtual ModuleBase_ModelWidget* preselectionWidget() const;
+
+  /// Sets widget processed by preselection
+  virtual void setPreselectionWidget(ModuleBase_ModelWidget* theWidget);
+
+  /// Returns operation manager
+  XGUI_OperationMgr* operationMgr() const { return myOperationMgr; }
+
+public slots:
+
+   /// \brief Update all widgets in property panel with values from the given feature
+   /// \param theFeature a Feature to update values in widgets
   void updateContentWidget(FeaturePtr theFeature);
-  // Enables / disables "ok" ("accept") button
-  void setAcceptEnabled(bool);
 
-  // Makes the given widget active, highlights it and removes
-  // highlighting from the previous active widget
-  // emits widgetActivated(theWidget) signal
+  /**
+  * Makes the given widget active, highlights it and removes
+  * highlighting from the previous active widget
+  * emits widgetActivated(theWidget) signal
+  * \param theWidget which has to be activated
+  */
   virtual void activateWidget(ModuleBase_ModelWidget* theWidget);
 
- signals:
-  /// Signal about the point 2d set to the feature
-  /// \param the feature
-  /// \param the attribute of the feature
-  //void storedPoint2D(ObjectPtr theFeature, const std::string& theAttribute);
+  void onActivateNextWidget(ModuleBase_ModelWidget* theWidget);
+
+signals:
+  void enterClicked();
+
+protected:
+  /// Makes the widget active, deactivate the previous, activate and hightlight the given one
+  /// \param theWidget a widget
+  bool setActiveWidget(ModuleBase_ModelWidget* theWidget);
+
+  /// The parent method that processes the "Tab"/"SHIF + Tab" keyboard events
+  /// Emits a signal about focus change
+  /// If theIsNext is true, this function searches forward, if next is false, it searches backward.
+  virtual bool focusNextPrevChild(bool theIsNext);
+
+  /// Activate the next widget in the property panel
+  /// \param theWidget a widget. The next widget should be activated
+  /// \param isCheckVisibility flag whether the next widget visibility is checked
+  void activateNextWidget(ModuleBase_ModelWidget* theWidget,
+                          const bool isCheckVisibility);
+
+ protected:
+   /// A method called on the property panel closed
+   /// \param theEvent a close event
+   void closeEvent(QCloseEvent* theEvent);
 
+  /// A header widget
+  QWidget* myHeaderWidget;
 
  private:
-  QWidget* myCustomWidget;
+  ModuleBase_PageWidget* myPanelPage;
   QList<ModuleBase_ModelWidget*> myWidgets;
-  QVBoxLayout* myMainLayout;
+
+  /// Currently active widget
   ModuleBase_ModelWidget* myActiveWidget;
+  /// Currently widget processed by preselection
+  ModuleBase_ModelWidget* myPreselectionWidget;
+
+  XGUI_OperationMgr* myOperationMgr;
 };
 
 #endif /* XGUI_PROPERTYPANEL_H_ */