Salome HOME
Issue #368 move constraint problem
[modules/shaper.git] / src / XGUI / XGUI_PropertyPanel.h
index d156289b56ee88ffd7ff72f302ca8890377b67c3..e632fe28d47dee3418d0a5aea74066cf7d7b261c 100644 (file)
@@ -1,3 +1,5 @@
+// Copyright (C) 2014-20xx CEA/DEN, EDF R&D -->
+
 /*
  * XGUI_PropertyPanel.h
  *
 #include "XGUI.h"
 
 #include <ModuleBase_ModelWidget.h>
+#include <ModuleBase_IPropertyPanel.h>
 
-#include <QDockWidget>
 #include <QList>
 
 class QKeyEvent;
 class QVBoxLayout;
 
-class XGUI_EXPORT XGUI_PropertyPanel: public QDockWidget
+/// 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";
+
+/**
+* Realization of Property panel object.
+*/
+class XGUI_EXPORT XGUI_PropertyPanel : public ModuleBase_IPropertyPanel
 {
-  Q_OBJECT
-public:
+Q_OBJECT
+ public:
+
+  /// Constructor
+  /// \param theParent is a parent of the property panel
   XGUI_PropertyPanel(QWidget* theParent);
+
   virtual ~XGUI_PropertyPanel();
 
+  /// Returns main widget of the property panel, which children will be created
+  /// by WidgetFactory using the XML definition
   QWidget* contentWidget();
+
+  /// Brings back all widget created by widget factory for signal/slot
+  /// connections and further processing
   void setModelWidgets(const QList<ModuleBase_ModelWidget*>& theWidgets);
 
+  /// Returns all property panel's widget created by WidgetFactory
+  virtual const QList<ModuleBase_ModelWidget*>& modelWidgets() const;
+
+  /// Removes all widgets in the widget area of the property panel
   void cleanContent();
 
-protected:
-  virtual bool eventFilter(QObject *theObject, QEvent *theEvent);
+  /// Returns currently active widget
+  virtual ModuleBase_ModelWidget* activeWidget() const { return myActiveWidget; }
 
-public slots:
-  void updateContentWidget(FeaturePtr theFeature);
-  /// slot to set the focus to the widget visualized an attribute with the given name
-  /// \param theAttributteName
-  void onFocusActivated(const std::string& theAttributeName);
-  /// slot to activate the next widget in the property panel
+  /// Activate the next widget in the property panel
   /// \param theWidget a widget. The next widget should be activated
-  void onActivateNextWidget(ModuleBase_ModelWidget* theWidget);
-
-signals:
-  /// The signal about key release on the control, that corresponds to the attribute
-  /// \param theAttributeName a name of the attribute
-  /// \param theEvent key release event
-  void keyReleased(const std::string& theAttributeName, QKeyEvent* theEvent);
-  /// The signal about the widget activation
-  /// \param theWidget the activated widget
-  void widgetActivated(ModuleBase_ModelWidget* theWidget);
-
-protected:
-  /// Activate the widget, which means the focus on the widget.
-  /// The signal about the widget activation is emitted
-  /// \param theWidget
-  void activateWidget(ModuleBase_ModelWidget* theWidget);
-
-private:
-  QWidget* myCustomWidget;
+  virtual void activateNextWidget(ModuleBase_ModelWidget* theWidget);
 
-  QList<ModuleBase_ModelWidget*> myWidgets;
+  /// Activate the next from current widget in the property panel
+  virtual void activateNextWidget();
+
+  /// \brief Enable/Disable stretch area in the panel
+  void setStretchEnabled(bool isEnabled);
 
+  /// Set Enable/Disable state of Cancel button
+  /// \param theEnabled Enable/Disable state of Cancel button
+  virtual void setCancelEnabled(bool theEnabled);
+
+  /// \return Enable/Disable state of Cancel button
+  virtual bool isCancelEnabled() const;
+
+  /// 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);
+
+ 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
+  /// \param toEnable enable/disable state of button
+  void setAcceptEnabled(bool toEnable);
+
+  /**
+  * 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);
+
+ private:
+  QWidget* myCustomWidget;
+  QList<ModuleBase_ModelWidget*> myWidgets;
   QVBoxLayout* myMainLayout;
+
+  /// Currently active widget
+  ModuleBase_ModelWidget* myActiveWidget;
 };
 
 #endif /* XGUI_PROPERTYPANEL_H_ */