Salome HOME
Update code documentation
authorvsv <vitaly.smetannikov@opencascade.com>
Wed, 28 Jan 2015 14:33:33 +0000 (17:33 +0300)
committervsv <vitaly.smetannikov@opencascade.com>
Wed, 28 Jan 2015 14:33:33 +0000 (17:33 +0300)
29 files changed:
src/ModuleBase/ModuleBase_ViewerPrs.h
src/NewGeom/NewGeom_SalomeViewer.h
src/PartSet/CMakeLists.txt
src/PartSet/PartSet_EditLine.cpp [deleted file]
src/PartSet/PartSet_EditLine.h [deleted file]
src/PartSet/PartSet_Filters.h
src/PartSet/PartSet_Module.h
src/PartSet/PartSet_Operation.cpp [deleted file]
src/PartSet/PartSet_Operation.h [deleted file]
src/PartSet/PartSet_SketcherMgr.h
src/PartSet/PartSet_Tools.h
src/PartSet/PartSet_Validators.h
src/PartSet/PartSet_WidgetPoint2d.h
src/PartSet/PartSet_WidgetPoint2dDistance.h
src/PartSet/PartSet_WidgetShapeSelector.h
src/PartSet/PartSet_WidgetSketchLabel.h
src/XGUI/XGUI_ContextMenuMgr.h
src/XGUI/XGUI_DataTreeModel.h
src/XGUI/XGUI_DocumentDataModel.h
src/XGUI/XGUI_ModuleConnector.h
src/XGUI/XGUI_OperationMgr.h
src/XGUI/XGUI_PartDataModel.h
src/XGUI/XGUI_QtEvents.h
src/XGUI/XGUI_SalomeConnector.h
src/XGUI/XGUI_SelectionMgr.h
src/XGUI/XGUI_Tools.h
src/XGUI/XGUI_ViewerProxy.h
src/XGUI/XGUI_Workshop.cpp
src/XGUI/XGUI_Workshop.h

index 6dec54b93b605eb2aa7442bd3f89a5f38f0bcfec..3a189d37bda920f965a7136f4972715a7c5b9b3d 100644 (file)
@@ -29,7 +29,7 @@ class ModuleBase_ViewerPrs
   }
 
   /// Constructor
-  /// \param theFeature a model feature
+  /// \param theResult an object
   /// \param theShape a viewer shape
   /// \param theOwner a selection owner
   ModuleBase_ViewerPrs(ObjectPtr theResult, const TopoDS_Shape& theShape,
@@ -45,8 +45,8 @@ class ModuleBase_ViewerPrs
   {
   }
 
-  /// Sets the feature.
-  /// \param theFeature a feature instance
+  /// Sets the object.
+  /// \param theResult an object instance
   void setFeature(ObjectPtr theResult)
   {
     myResult = theResult;
@@ -59,8 +59,8 @@ class ModuleBase_ViewerPrs
     return myResult;
   }
 
-  /// Returns the presentation owner
-  /// \param the owner
+  /// Set the presentation owner
+  /// \param theOwner an owner to set
   void setOwner(Handle_SelectMgr_EntityOwner theOwner)
   {
     myOwner = theOwner;
@@ -87,16 +87,21 @@ class ModuleBase_ViewerPrs
     return myShape;
   }
 
+  /// Set interactive object
+  /// \param theIO an interactive object
   void setInteractive(const Handle(AIS_InteractiveObject)& theIO)
   {
     myInteractive = theIO;
   }
 
+  /// Returns interactive object if it is installed
   Handle(AIS_InteractiveObject) interactive() const
   {
     return myInteractive;
   }
 
+  /// Returns True if the current object is equal to the given one
+  /// \param thePrs an object to compare
   bool operator==(const ModuleBase_ViewerPrs& thePrs)
   {
     bool aResult = (myResult.get() == thePrs.object().get());
@@ -110,7 +115,7 @@ class ModuleBase_ViewerPrs
   ObjectPtr myResult;  /// the feature
   Handle(SelectMgr_EntityOwner) myOwner;  /// the selection owner
   TopoDS_Shape myShape;  /// the shape
-  Handle(AIS_InteractiveObject) myInteractive;
+  Handle(AIS_InteractiveObject) myInteractive;  /// interactive object
 };
 
 #endif
index 0377ce7e06d17ed86a351dc1cd22a6b271d40b8e..ca3675b9b4c1981e3413f30f8f4bf67faeac4c26 100644 (file)
@@ -32,7 +32,11 @@ public:
 
   virtual Handle(V3d_View) v3dView() const;
 
+  /// Set the current viewer
+  /// \param theViewer a viewer instance
   void setViewer(OCCViewer_Viewer* theViewer) { myViewer = theViewer; }
+
+  /// Returns current viewer
   OCCViewer_Viewer* viewer() const { return myViewer; }
 
 private:
@@ -85,6 +89,8 @@ Q_OBJECT
   /// \param theZ the Z projection value
   virtual void setViewProjection(double theX, double theY, double theZ);
 
+  /// Set selector
+  /// \param theSel a selector instance
   void setSelector(NewGeom_OCCSelector* theSel);
 
   /// Add selection filter to the viewer
@@ -96,6 +102,7 @@ Q_OBJECT
   /// Remove all selection filters from the viewer
   virtual void clearSelectionFilters();
 
+  /// Returns current selector
   NewGeom_OCCSelector* selector() const
   {
     return mySelector;
index 9f0f38e8b15e17aa01767a6e92ea611150464b49..8c0eff95509abcfe7d2d04ecaad31d1ecb94be5e 100644 (file)
@@ -7,7 +7,6 @@ SET(CMAKE_AUTOMOC ON)
 SET(PROJECT_HEADERS
        PartSet.h
        PartSet_Constants.h
-       PartSet_EditLine.h
        PartSet_Module.h
        PartSet_Tools.h
        PartSet_WidgetSketchLabel.h
@@ -20,7 +19,6 @@ SET(PROJECT_HEADERS
 )
 
 SET(PROJECT_SOURCES
-       PartSet_EditLine.cpp
        PartSet_Module.cpp
        PartSet_Tools.cpp
        PartSet_WidgetSketchLabel.cpp
diff --git a/src/PartSet/PartSet_EditLine.cpp b/src/PartSet/PartSet_EditLine.cpp
deleted file mode 100644 (file)
index c063172..0000000
+++ /dev/null
@@ -1,50 +0,0 @@
-// Copyright (C) 2014-20xx CEA/DEN, EDF R&D
-
-// File:        PartSet_EditLine.h
-// Created:     02 June 2014
-// Author:      Natalia ERMOLAEVA
-
-#include <PartSet_EditLine.h>
-
-#include <QLineEdit>
-
-PartSet_EditLine::PartSet_EditLine(QWidget* theParent)
-    : QObject(theParent)
-{
-  myEditor = new QLineEdit(theParent);
-  myEditor->setWindowFlags(Qt::ToolTip);
-  myEditor->setFocusPolicy(Qt::StrongFocus);
-
-  connect(myEditor, SIGNAL(returnPressed()), this, SLOT(onStopEditing()));
-}
-
-void PartSet_EditLine::start(const QPoint& thePoint, double theValue)
-{
-  myEditor->move(thePoint);
-  myEditor->setText(QString::number(theValue));
-  myEditor->show();
-
-  myEditor->selectAll();
-  myEditor->setFocus();
-}
-
-bool PartSet_EditLine::isStarted() const
-{
-  return myEditor->isVisible();
-}
-
-void PartSet_EditLine::stop()
-{
-  myEditor->hide();
-}
-
-double PartSet_EditLine::getValue() const
-{
-  return myEditor->text().toDouble();
-}
-
-void PartSet_EditLine::onStopEditing()
-{
-  stop();
-  emit stopped(getValue());
-}
diff --git a/src/PartSet/PartSet_EditLine.h b/src/PartSet/PartSet_EditLine.h
deleted file mode 100644 (file)
index cf85b78..0000000
+++ /dev/null
@@ -1,64 +0,0 @@
-// Copyright (C) 2014-20xx CEA/DEN, EDF R&D
-
-// File:        PartSet_EditLine.h
-// Created:     02 Jun 2014
-// Author:      Natalia ERMOLAEVA
-
-#ifndef PartSet_EditLine_H
-#define PartSet_EditLine_H
-
-#include "PartSet.h"
-
-#include <QObject>
-#include <QPoint>
-
-class QLineEdit;
-class QWidget;
-
-/*!
- \class PartSet_EditLine
- * \brief The class to give an editor to modify a real value
- */
-class PARTSET_EXPORT PartSet_EditLine : public QObject
-{
-Q_OBJECT
- public:
-  /// Constructor
-  PartSet_EditLine(QWidget* theParent);
-  /// Destructor
-  virtual ~PartSet_EditLine()
-  {
-  }
-  ;
-
-  /// Show the editor in the given global position
-  /// \param thePoint a position
-  /// \param theValue a value for the editor
-  void start(const QPoint& thePoint, double theValue);
-
-  /// Checks whether the editor is started
-  /// \returns true if the editor is activated
-  bool isStarted() const;
-
-  /// Stop the editor, in other words hide it
-  void stop();
-
-signals:
-  /// Signals about the editing stop
-  /// \param theValue the editor value
-  void stopped(double theValue);
-
- protected:
-  /// Returns the editor value
-  /// \return the real value
-  double getValue() const;
-
- protected slots:
-  /// Slot to check the editing stop
-  void onStopEditing();
-
- protected:
-  QLineEdit* myEditor;  /// the value editor
-};
-
-#endif
index 56a34e531a7b21f8bc7ea4d5938fba245a0e6694..1eac11c7be2f4e9edbda018b0a7d376b36bb60d1 100644 (file)
 
 
 /**
+* \class PartSet_GlobalFilter
+* \ingroup Module
 * A class which filters groups object in addition to documents (see issue #310)
 */
 DEFINE_STANDARD_HANDLE(PartSet_GlobalFilter, ModuleBase_ShapeDocumentFilter);
 class PartSet_GlobalFilter: public ModuleBase_ShapeDocumentFilter
 {
 public:
+  /// Constructor
+  /// \param theWorkshop a pointer to workshop
   PartSet_GlobalFilter(ModuleBase_IWorkshop* theWorkshop)
     : ModuleBase_ShapeDocumentFilter(theWorkshop) {}
 
+  /// Returns True if selected presentation can be selected
+  /// \param theOwner an owner of the persentation
   Standard_EXPORT virtual Standard_Boolean IsOk(const Handle(SelectMgr_EntityOwner)& theOwner) const;
 
   DEFINE_STANDARD_RTTI(PartSet_GlobalFilter)
index 9723d53e3684b01f6fb42840e34ff0bdcd32c86d..529553713b4f43fc956cd2b287b9b2c89851de68 100644 (file)
 class ModuleBase_Operation;
 class ModuleBase_IViewWindow;
 
+/**
+* \ingroup Module
+* Implementation of Partset module
+*/
 class PARTSET_EXPORT PartSet_Module : public ModuleBase_IModule
 {
 Q_OBJECT
@@ -39,6 +43,8 @@ enum RestartingMode {
 };
 
 public:
+  /// Constructor
+  /// \param theWshop a pointer to a workshop
   PartSet_Module(ModuleBase_IWorkshop* theWshop);
   virtual ~PartSet_Module();
 
@@ -80,28 +86,8 @@ protected slots:
   /// Called when previous operation is finished
   virtual void onSelectionChanged();
 
-  /// SLOT, that is called by mouse press in the viewer.
-  /// \param theWnd - the window where the event happens
-  /// \param theEvent the mouse event
-  //void onMousePressed(ModuleBase_IViewWindow* theWnd, QMouseEvent* theEvent);
-
-  /// SLOT, that is called by mouse release in the viewer.
-  /// \param theWnd - the window where the event happens
-  /// \param theEvent the mouse event
-  //void onMouseReleased(ModuleBase_IViewWindow* theWnd, QMouseEvent* theEvent);
-  
-  /// SLOT, that is called by mouse move in the viewer.
-  /// \param theWnd - the window where the event happens
-  /// \param theEvent the mouse event
-  //void onMouseMoved(ModuleBase_IViewWindow* theWnd, QMouseEvent* theEvent);
-
-  /// SLOT, that is called by mouse double click in the viewer.
-  /// \param theWnd - the window where the event happens
-  /// \param theEvent the mouse event
-  //void onMouseDoubleClick(ModuleBase_IViewWindow* theWnd, QMouseEvent* theEvent);
-
   /// SLOT, that is called by key release in the viewer.
-  /// The mouse moved point is sent to the current operation to be processed.
+  /// \param theWnd a view window
   /// \param theEvent the key event
   void onKeyRelease(ModuleBase_IViewWindow* theWnd, QKeyEvent* theEvent);
 
@@ -122,11 +108,10 @@ protected slots:
   virtual void registerFilters();
 
  private slots:
+   /// Processing of vertex selected
    void onVertexSelected();
 
-
  private:
-
   /// Breaks sequense of automatically resterted operations
   void breakOperationSequence();
 
diff --git a/src/PartSet/PartSet_Operation.cpp b/src/PartSet/PartSet_Operation.cpp
deleted file mode 100644 (file)
index 1335289..0000000
+++ /dev/null
@@ -1,19 +0,0 @@
-// Copyright (C) 2014-20xx CEA/DEN, EDF R&D
-
-// File:        PartSet_Operation.cpp
-// Created:     24 Nov 2014
-// Author:      Vitaly SMETANNIKOV
-
-#include "PartSet_Operation.h"
-
-#include <ModuleBase_IWorkshop.h>
-#include <ModuleBase_ISelection.h>
-
-void PartSet_Operation::onSelectionChanged()
-{
-  if (isEditOperation()) {
-    ModuleBase_ISelection* aSelection = myWorkshop->selection();
-    QList<ModuleBase_ViewerPrs> aHighlighted = aSelection->getHighlighted();
-    QList<ModuleBase_ViewerPrs> aSelected = aSelection->getSelected();
-  }
-}
\ No newline at end of file
diff --git a/src/PartSet/PartSet_Operation.h b/src/PartSet/PartSet_Operation.h
deleted file mode 100644 (file)
index 83fce7e..0000000
+++ /dev/null
@@ -1,32 +0,0 @@
-// Copyright (C) 2014-20xx CEA/DEN, EDF R&D
-
-// File:        PartSet_Operation.h
-// Created:     24 Nov 2014
-// Author:      Vitaly SMETANNIKOV
-
-#ifndef PartSet_Operation_H
-#define PartSet_Operation_H
-
-#include "PartSet.h"
-
-#include <ModuleBase_Operation.h>
-
-class ModuleBase_IWorkshop;
-
-class PARTSET_EXPORT PartSet_Operation : public ModuleBase_Operation
-{
-Q_OBJECT
- public:
-   PartSet_Operation(const QString& theId = "", QObject* theParent = 0)
-     :ModuleBase_Operation(theId, theParent) {}
-
-   void setWorkshop(ModuleBase_IWorkshop* theWorkshop) { myWorkshop = theWorkshop; } 
-
-public slots:
-  void onSelectionChanged();
-
-private:
-  ModuleBase_IWorkshop* myWorkshop;
-};
-
-#endif
\ No newline at end of file
index 0b79b084e0b18dd31deab0e8e67835c622e0b9a4..97dbea056017349e63fc3672564fafb58233ef27 100644 (file)
@@ -31,6 +31,7 @@ class ModuleBase_Operation;
 class QMouseEvent;
 
 /**
+* \ingroup Module
 * A class for management of sketch operations
 */
 class PARTSET_EXPORT PartSet_SketcherMgr : public QObject
@@ -67,25 +68,29 @@ class PARTSET_EXPORT PartSet_SketcherMgr : public QObject
     double myCurX, myCurY; /// the point coordinates
   };
 public:
+  /// Constructor
+  /// \param theModule a pointer to PartSet module
   PartSet_SketcherMgr(PartSet_Module* theModule);
 
   virtual ~PartSet_SketcherMgr();
 
+  /// Returns list of strings which contains id's of sketch operations
   static QStringList sketchOperationIdList();
 
   /// Launches the operation from current highlighting
   void launchEditing();
 
-  // Returns current Sketch feature/ Returns NULL if there is no launched sketch operation
+  /// Returns current Sketch feature/ Returns NULL if there is no launched sketch operation
   CompositeFeaturePtr activeSketch() const { return myCurrentSketch; }
 
   /// Starts sketch operation
-  void startSketch(ModuleBase_Operation* theOperation);
+  void startSketch(ModuleBase_Operation* );
 
   /// Stops sketch operation
-  void stopSketch(ModuleBase_Operation* theOperation);
+  void stopSketch(ModuleBase_Operation* );
 
 public slots:
+  /// Process sketch plane selected event
   void onPlaneSelected(const std::shared_ptr<GeomAPI_Pln>& thePln);
 
 
index 05104bb016714dc2e42ab9d47173c04d054c753a..058c00baa659ecaba0400819f61da0535b092004 100644 (file)
@@ -33,7 +33,8 @@ class GeomAPI_Edge;
 class GeomAPI_Vertex;
 
 /*!
- \class PartSet_Tools
+ * \class PartSet_Tools
+ * \ingroup Module
  * \brief The operation for the sketch feature creation
  */
 class PARTSET_EXPORT PartSet_Tools
@@ -42,12 +43,12 @@ class PARTSET_EXPORT PartSet_Tools
   /// Converts the 2D screen point to the 3D point on the view according to the point of view
   /// \param thePoint a screen point
   /// \param theView a 3D view
-  // Transferred to ModuleBase
   static gp_Pnt convertClickToPoint(QPoint thePoint, Handle_V3d_View theView);
 
   /// \brief Converts the 3D point to the projected coodinates on the sketch plane.
   /// \param thePoint the 3D point in the viewer
   /// \param theSketch the sketch feature
+  /// \param theView a view 3d object
   /// \param theX the X coordinate
   /// \param theY the Y coordinate
   static void convertTo2D(const gp_Pnt& thePoint, FeaturePtr theSketch,
@@ -58,7 +59,6 @@ class PARTSET_EXPORT PartSet_Tools
   /// \param theX the X coordinate
   /// \param theY the Y coordinate
   /// \param theSketch the sketch feature
-  /// \param thePoint the 3D point in the viewer
   static std::shared_ptr<GeomAPI_Pnt> convertTo3D(const double theX, const double theY, FeaturePtr theSketch);
 
   /// Returns an object that is under the mouse point. Firstly it checks the highlighting,
@@ -77,7 +77,12 @@ class PARTSET_EXPORT PartSet_Tools
   /// Returns pointer to the root document.
   static std::shared_ptr<ModelAPI_Document> document();
 
-
+  /// Find an attribute which corresponds to a given pont coordinates
+  /// \param theSketch the sketch feature
+  /// \param theX X coordinate
+  /// \param theY Y coordinate
+  /// \param theTolerance tolerance
+  /// \param theIgnore list of features which has to be ignored
   static std::shared_ptr<GeomDataAPI_Point2D> findAttributePoint(CompositeFeaturePtr theSketch, 
     double theX, double theY, double theTolerance, const QList<FeaturePtr>& theIgnore = QList<FeaturePtr>());
 
@@ -90,7 +95,7 @@ class PARTSET_EXPORT PartSet_Tools
 
   /// \brief Save the double to the feature. If the attribute is double, it is filled.
   /// \param theFeature the feature
-  /// \param theValue the horizontal coordinate
+  /// \param theX the horizontal coordinate
   /// \param theAttribute the feature attribute
   static void setFeatureValue(FeaturePtr theFeature, double theX, const std::string& theAttribute);
 
@@ -111,8 +116,9 @@ class PARTSET_EXPORT PartSet_Tools
                             const std::string& theKind);
 
   /// Creates a constraint on two points
+  /// \param theSketch a sketch feature
   /// \param thePoint1 the first point
-  /// \param thePoint1 the second point
+  /// \param thePoint2 the second point
   static void createConstraint(CompositeFeaturePtr theSketch,
                                std::shared_ptr<GeomDataAPI_Point2D> thePoint1,
                                std::shared_ptr<GeomDataAPI_Point2D> thePoint2);
@@ -145,8 +151,10 @@ class PARTSET_EXPORT PartSet_Tools
 
   /// Creates a line (arc or circle) by given edge
   /// Created line will have fixed constraint
-  /// \param theEdge - an edge
-  /// \return - result of created feature
+  /// \param theShape an edge
+  /// \param theObject a selected result object
+  /// \param theSketch a sketch feature
+  /// \return result of created feature
   static ResultPtr createFixedObjectByEdge(const TopoDS_Shape& theShape, 
                                            const ObjectPtr& theObject, 
                                            CompositeFeaturePtr theSketch);
index eb44d6daae3eaaf8e6d1116eadcda3ecbb13f39b..6334a87c73784a6e08dc9948491ad7c0131470e8 100644 (file)
@@ -60,25 +60,43 @@ class PartSet_RigidValidator : public ModuleBase_SelectionValidator
   PARTSET_EXPORT virtual bool isValid(const ModuleBase_ISelection* theSelection) const;
 };
 
+/**
+* \ingroup Module
+* A validator which checks that objects selected for feature attributes are different (not the same)
+*/
 class PartSet_DifferentObjectsValidator : public ModelAPI_RefAttrValidator
 {
  public:
+   /// Returns True if the feature is valid
+   /// \param theFeature a feature to check
+   /// \param theArguments a list of arguments (names of attributes to check)
+   /// \param theObject a selected object
   virtual bool isValid(const FeaturePtr& theFeature, const std::list<std::string>& theArguments,
                        const ObjectPtr& theObject) const;
+
   //! Returns true if the attribute is good for the feature attribute
+  //! \param theFeature a feature to check
+  //! \param theArguments a list of arguments (names of attributes to check)
+  //! \param theAttribute an attribute
   virtual bool isValid(const FeaturePtr& theFeature, const std::list<std::string>& theArguments,
                        const AttributePtr& theAttribute) const;
 
+  //! Returns true if the attribute is good for the feature attribute
+  //! \param theAttribute an attribute
+  //! \param theArguments a list of arguments (names of attributes to check)
   virtual bool isValid(const AttributePtr& theAttribute,
                        const std::list<std::string>& theArguments) const;
 };
 
 /**
-* aValidator which validates tha selected object is a Sketch
+* \ingroup Module
+* A Validator which validates tha selected object is a Sketch
 */
 class PartSet_SketchValidator : public ModelAPI_ResultValidator
 {
  public:
+   /// Returns True if the given object is a sketch
+   /// \param theObject an object
   virtual bool isValid(const ObjectPtr theObject) const;
 };
 
index ad0395461f2375f1ac8a4b0c2ad3578f4b69c23a..59649caad4fb446baacded2d5e7c00f9d21e08c1 100644 (file)
@@ -27,17 +27,21 @@ class QGroupBox;
 class QMouseEvent;
 
 /**\class PartSet_WidgetPoint2D
- * \ingroup GUI
- * \brief Custom widget. An abstract class to be redefined to fill with some GUI controls
+ * \ingroup Module
+ * \brief Implementation of model widget to provide widget to input point 2d
+ * In XML can be defined as folloung:
+ * \code
+ * <sketch-2dpoint_selector id="CircleCenter" title="Center" tooltip="Center coordinates"/>
+ * \endcode
  */
 class PARTSET_EXPORT PartSet_WidgetPoint2D : public ModuleBase_ModelWidget
 {
 Q_OBJECT
  public:
   /// Constructor
-  /// \theParent the parent object
-  /// \theParent the parent object
-  /// \theData the widget configuation. The attribute of the model widget is obtained from
+  /// \param theParent the parent object
+  /// \param theData the widget configuation. The attribute of the model widget is obtained from
+  /// \param theParentId is Id of a parent of the current attribute
   PartSet_WidgetPoint2D(QWidget* theParent, const Config_WidgetAPI* theData, 
                         const std::string& theParentId);
   /// Destructor
@@ -48,8 +52,6 @@ Q_OBJECT
   /// \param theValue the wrapped widget value
   virtual bool setSelection(ModuleBase_ViewerPrs theValue);
 
-  /// Saves the internal parameters to the given feature
-  /// \param theObject a model feature to be changed
   virtual bool storeValue() const;
 
   virtual bool restoreValue();
@@ -70,16 +72,21 @@ Q_OBJECT
   /// The methiod called when widget is deactivated
   virtual void deactivate();
 
+  /// Return workshop
   XGUI_Workshop* workshop() const { return myWorkshop; }
 
+  /// Set workshop
   void setWorkshop(XGUI_Workshop* theWork) { myWorkshop = theWork; }
 
   /// \returns the sketch instance
   CompositeFeaturePtr sketch() const { return mySketch; }
+
+  /// Set sketch instance
   void setSketch(CompositeFeaturePtr theSketch) { mySketch = theSketch; }
 
   /// Fill the widget values by given point
-  /// \param thePoint the point
+  /// \param theX the X coordinate
+  /// \param theY the Y coordinate
   void setPoint(double theX, double theY);
 
   /// Returns coordinate X currently defined in the control
@@ -90,18 +97,29 @@ Q_OBJECT
 
 signals:
   /// Signal about selection of an existing vertex from an object
-  /// \param theObject - the selected object
-  /// \param theShape - the selected shape
   void vertexSelected();
 
 protected slots:
+  /// Process mouse release event
+  /// \param theWnd a view window
+  /// \param theEvent a mouse event
   void onMouseRelease(ModuleBase_IViewWindow* theWnd, QMouseEvent* theEvent);
+
+  /// Process mouse move event
+  /// \param theWnd a view window
+  /// \param theEvent a mouse event
   void onMouseMove(ModuleBase_IViewWindow* theWnd, QMouseEvent* theEvent);
 
 private slots:
+  /// Process value changed event
   void onValuesChanged();
 
  private:
+   /// Returns point 2d from selected vertex
+   /// \param theView a view window
+   /// \param theShape a vertex shape
+   /// \param theX an output value of X coordinate
+   /// \param theY an output value of Y coordinate
    bool getPoint2d(const Handle(V3d_View)& theView, const TopoDS_Shape& theShape, 
                    double& theX, double& theY) const;
 
index ca95b75fd3ee11f0bd851fa1319dbc76d4a9985d..50c2626a4d4f499c7c342191ed5dec13239cfeb9 100644 (file)
@@ -17,13 +17,31 @@ class XGUI_Workshop;
 class ModuleBase_IViewWindow;
 class QMouseEvent;
 
+/**
+* \ingroup Module
+* Implementation of model widget for widget which provides input of a distance between two points
+* In XML file can be defined as following:
+* \code
+* <point2ddistance id="CircleRadius" 
+*   first_point="CircleCenter" 
+*   label="Radius:" 
+*   min="0" 
+*   step="1.0" 
+*   default="0" 
+*   icon=":icons/radius.png" 
+*   tooltip="Set radius">
+*   <validator id="GeomValidators_Positive"/>
+* </point2ddistance>
+* \endcode
+*/ 
 class PARTSET_EXPORT PartSet_WidgetPoint2dDistance : public ModuleBase_WidgetDoubleValue
 {
 Q_OBJECT
  public:
   /// Constructor
-  /// \theParent the parent object
-  /// \theData the widget configuation. The attribute of the model widget is obtained from
+  /// \param theParent the parent object
+  /// \param theData the widget configuation. The attribute of the model widget is obtained from
+  /// \param theParentId is Id of a parent of the current attribute
   PartSet_WidgetPoint2dDistance(QWidget* theParent, const Config_WidgetAPI* theData,
                                    const std::string& theParentId);
 
@@ -35,21 +53,28 @@ Q_OBJECT
   /// The methiod called when widget is deactivated
   virtual void deactivate();
 
-  /// Set the given wrapped value to the current widget
-  /// This value should be processed in the widget according to the needs
-  /// \param theValue the wrapped widget value
-  //virtual bool setValue(ModuleBase_WidgetValue* theValue);
-
+  /// Returns workshop
   XGUI_Workshop* workshop() const { return myWorkshop; }
 
+  /// Set workshop
+  /// \param theWork a pointer to workshop
   void setWorkshop(XGUI_Workshop* theWork) { myWorkshop = theWork; }
 
   /// \returns the sketch instance
   CompositeFeaturePtr sketch() const { return mySketch; }
+
+  /// Set sketch instance
   void setSketch(CompositeFeaturePtr theSketch) { mySketch = theSketch; }
 
  protected slots:
+   /// Process of mouse release
+   /// \param theWnd a pointer to a window
+   /// \param theEvent a mouse event
   void onMouseRelease(ModuleBase_IViewWindow* theWnd, QMouseEvent* theEvent);
+
+   /// Process of mouse move
+   /// \param theWnd a pointer to a window
+   /// \param theEvent a mouse event
   void onMouseMove(ModuleBase_IViewWindow* theWnd, QMouseEvent* theEvent);
 
 protected:
@@ -57,6 +82,7 @@ protected:
   void setPoint(FeaturePtr theFeature, const std::shared_ptr<GeomAPI_Pnt2d>& thePnt);
 
 private slots:
+  /// Process values changed event
   void onValuesChanged();
 
  private:
index 8f187cd8b47b1d1f8074506210f471f690ce91b6..6c81641c83e08ffa443756a2a7b77e18d53158e9 100644 (file)
 
 #include <ModelAPI_CompositeFeature.h>
 
+
+/**
+* \ingroup Module
+* Customosation of ModuleBase_WidgetShapeSelector in order to provide 
+* working with sketch specific objects.
+*/
 class PARTSET_EXPORT PartSet_WidgetShapeSelector: public ModuleBase_WidgetShapeSelector
 {
 Q_OBJECT
  public:
+  /// Constructor
+  /// \param theParent the parent object
+  /// \param theWorkshop instance of workshop interface
+  /// \param theData the widget configuation. The attribute of the model widget is obtained from
+  /// \param theParentId is Id of a parent of the current attribute
   PartSet_WidgetShapeSelector(QWidget* theParent, ModuleBase_IWorkshop* theWorkshop,
     const Config_WidgetAPI* theData, const std::string& theParentId)
     : ModuleBase_WidgetShapeSelector(theParent, theWorkshop, theData, theParentId) {}
 
   virtual ~PartSet_WidgetShapeSelector() {}
 
-  /// Saves the internal parameters to the given feature
   virtual bool storeValue() const;
 
+  /// Set sketcher
+  /// \param theSketch a sketcher object
   void setSketcher(CompositeFeaturePtr theSketch) { mySketch = theSketch; }
+
+  /// Retrurns installed sketcher
   CompositeFeaturePtr sketch() const { return mySketch; }
 
 protected:
@@ -35,14 +49,24 @@ protected:
   virtual bool isValid(ObjectPtr theObj, std::shared_ptr<GeomAPI_Shape> theShape);
 
 private:
+  /// Pointer to a sketch 
   CompositeFeaturePtr mySketch;
 };
 
-
+/**
+* \ingroup Module
+* Customosation of ModuleBase_WidgetShapeSelector in order to provide 
+* working with constraints.
+*/
 class PARTSET_EXPORT PartSet_WidgetConstraintShapeSelector: public ModuleBase_WidgetShapeSelector
 {
 Q_OBJECT
  public:
+  /// Constructor
+  /// \param theParent the parent object
+  /// \param theWorkshop instance of workshop interface
+  /// \param theData the widget configuation. The attribute of the model widget is obtained from
+  /// \param theParentId is Id of a parent of the current attribute
   PartSet_WidgetConstraintShapeSelector(QWidget* theParent, ModuleBase_IWorkshop* theWorkshop,
     const Config_WidgetAPI* theData, const std::string& theParentId)
     : ModuleBase_WidgetShapeSelector(theParent, theWorkshop, theData, theParentId) {}
@@ -52,10 +76,15 @@ Q_OBJECT
   /// Saves the internal parameters to the given feature
   virtual bool storeValue() const;
 
+  /// Set sketcher
+  /// \param theSketch a sketcher object
   void setSketcher(CompositeFeaturePtr theSketch) { mySketch = theSketch; }
+
+  /// Retrurns installed sketcher
   CompositeFeaturePtr sketch() const { return mySketch; }
 
 private:
+  /// Pointer to a sketch 
   CompositeFeaturePtr mySketch;
 };
 
index 0dbc1da33c9c93caf3c0a256d829b74332166baa..ac845c279ada0c1e8724e209691759fb05877e0f 100644 (file)
@@ -24,17 +24,24 @@ class QTimer;
 class XGUI_OperationMgr;
 class XGUI_Workshop;
 
+/**
+* \ingroup Module
+* A model widget implementation for a label which provides specific behaviour 
+* for sketcher starting and launching operations
+*/
 class PARTSET_EXPORT PartSet_WidgetSketchLabel : public ModuleBase_ModelWidget
 {
 Q_OBJECT
  public:
+  /// Constructor
+  /// \param theParent the parent object
+  /// \param theData the widget configuation. The attribute of the model widget is obtained from
+  /// \param theParentId is Id of a parent of the current attribute
   PartSet_WidgetSketchLabel(QWidget* theParent, const Config_WidgetAPI* theData,
                             const std::string& theParentId);
 
   virtual ~PartSet_WidgetSketchLabel();
 
-  /// Saves the internal parameters to the given feature
-  /// \param theFeature a model feature to be changed
   virtual bool storeValue() const
   {
     return true;
@@ -57,27 +64,44 @@ Q_OBJECT
   /// The methiod called when widget is deactivated
   virtual void deactivate();
 
+  /// Returns pointer to workshop
   XGUI_Workshop* workshop() const { return myWorkshop; }
 
+  /// Set pointer to workshop
+  /// \param theWork a pointer to workshop
   void setWorkshop(XGUI_Workshop* theWork) { myWorkshop = theWork; }
 
+  /// Returns sketcher plane
   std::shared_ptr<GeomAPI_Pln> plane() const;
 
 signals:
+  /// Signal on plane selection
   void planeSelected(const std::shared_ptr<GeomAPI_Pln>& thePln);
 
  private slots:
+   /// Slot on plane selection
   void onPlaneSelected();
+
+  /// Set sketch specific mode of selection
   void setSketchingMode();
 
  private:
+   /// Create preview of planes for sketch plane selection
+   /// \param theOrigin an origin of the plane
+   /// \param theNorm a normal vector of the plane
+   /// \param theRGB a color of plane presentation [r, g, b] array
   AISObjectPtr createPreviewPlane(std::shared_ptr<GeomAPI_Pnt> theOrigin, 
                                   std::shared_ptr<GeomAPI_Dir> theNorm, 
                                   const int theRGB[3]);
 
+  /// Set sketch plane by shape
+  /// \param theShape a planar face
   std::shared_ptr<GeomAPI_Dir> setSketchPlane(const TopoDS_Shape& theShape);
 
+  /// Erase preview planes
   void erasePreviewPlanes();
+
+  /// Show preview planes
   void showPreviewPlanes();
 
 
index c7af183f4e104de9ded8fb8a1d6fce0cf1e5a3ae..0fe548e2a1a3b847238b7e5fbeb00a311ed724e8 100644 (file)
@@ -20,6 +20,8 @@ class XGUI_EXPORT XGUI_ContextMenuMgr : public QObject
 {
 Q_OBJECT
  public:
+   /// Constructor
+   /// \param theParent a parent object
   XGUI_ContextMenuMgr(XGUI_Workshop* theParent);
   virtual ~XGUI_ContextMenuMgr();
 
@@ -27,6 +29,7 @@ Q_OBJECT
   void createActions();
 
   /// Returns action according to the given ID
+  /// \param theId an id of an action
   QAction* action(const QString& theId) const;
 
   /// Returns list of registered actions Ids
@@ -42,14 +45,22 @@ Q_OBJECT
   void connectViewer() const;
 
   /// Add menu atems for viewer into the given menu (used in SALOME mode)
+  /// \param theMenu a menu instance
   void addViewerItems(QMenu* theMenu) const;
 
 signals:
+  /// Signal aabout triggered action
+  /// \param theId an id of triggered action
+  /// \param isChecked is checked flag
   void actionTriggered(const QString& theId, bool isChecked);
 
  private slots:
+   /// Process action event
+   /// \param isChecked a checked action flag
   void onAction(bool isChecked);
 
+  /// Process context menu event
+  /// \param theEvent a context menu event
   void onContextMenuRequest(QContextMenuEvent* theEvent);
 
  private:
@@ -60,11 +71,16 @@ signals:
    */
   void addAction(const QString& theId, QAction* theAction);
 
+  /// Creates menu for object browser
   QMenu* objectBrowserMenu() const;
+
+  /// Creates menu for viewer
   QMenu* viewerMenu() const;
 
+  /// Map of created actions [id : Action]
   QMap<QString, QAction*> myActions;
 
+  /// Reference to workshop
   XGUI_Workshop* myWorkshop;
 };
 
index 72a3d93f5f4019787a1d1753a1acccb09d4d85f9..fb28e59f8406154317e05ff487e3527ef13c7482 100644 (file)
@@ -19,6 +19,8 @@
 class XGUI_EXPORT XGUI_FeaturesModel : public QAbstractItemModel
 {
  public:
+   /// Constructor
+   /// \param theParent a parent object
   XGUI_FeaturesModel(QObject* theParent)
       : QAbstractItemModel(theParent),
         myItemsColor(Qt::black)
@@ -27,6 +29,7 @@ class XGUI_EXPORT XGUI_FeaturesModel : public QAbstractItemModel
 
   //! Returns Feature object by the given Model index.
   //! Returns 0 if the given index is not index of a feature
+  /// \param theIndex a model index
   virtual ObjectPtr object(const QModelIndex& theIndex) const = 0;
 
   //! Returns QModelIndex which corresponds to the given feature
@@ -37,19 +40,23 @@ class XGUI_EXPORT XGUI_FeaturesModel : public QAbstractItemModel
   virtual QModelIndex findParent(const ObjectPtr& theObject) const = 0;
 
   //! Returns index corresponded to the group
+  //! \param theGroup a group name
   virtual QModelIndex findGroup(const std::string& theGroup) const = 0;
 
+  //! Set color of items
   void setItemsColor(const QColor& theColor)
   {
     myItemsColor = theColor;
   }
 
+  //! Returns color of items
   QColor itemsColor() const
   {
     return myItemsColor;
   }
 
  protected:
+   /// Color of items
   QColor myItemsColor;
 };
 
@@ -60,17 +67,22 @@ class XGUI_EXPORT XGUI_FeaturesModel : public QAbstractItemModel
 class XGUI_PartModel : public XGUI_FeaturesModel
 {
  public:
+   /// Constructor
+   /// \param theParent a parent object
   XGUI_PartModel(QObject* theParent)
       : XGUI_FeaturesModel(theParent)
   {
   }
 
+  /// Set part id
+  /// \param theId a new id
   void setPartId(int theId)
   {
     myId = theId;
   }
 
   //! Returns true if the given document is a sub-document of this tree
+  //! \param theDoc a document to check
   virtual bool hasDocument(const DocumentPtr& theDoc) const = 0;
 
   //! Return a Part object
index 0b3f35fd1797b3b09b47ac25a1f612fd3ffdcbf2..63fa17a9ff61e06dad3153b71c78e7749b618075 100644 (file)
@@ -25,45 +25,86 @@ class XGUI_EXPORT XGUI_DocumentDataModel : public QAbstractItemModel, public Eve
 {
 Q_OBJECT
  public:
-
+   /// Constructor
+   /// \param theParent a parent object
   XGUI_DocumentDataModel(QObject* theParent);
   virtual ~XGUI_DocumentDataModel();
 
-  // Event Listener method
+  /// Event Listener method
+  /// \param theMessage an event message
   virtual void processEvent(const std::shared_ptr<Events_Message>& theMessage);
 
+  /// Returns the data stored under the given role for the item referred to by the index.
+  /// \param theIndex a model index
+  /// \param theRole a data role (see Qt::ItemDataRole)
   virtual QVariant data(const QModelIndex& theIndex, int theRole) const;
+
+  /// Returns the data for the given role and section in the header with the specified orientation.
+  /// \param theSection a section
+  /// \param theOrient an orientation
+  /// \param theRole a data role (see Qt::ItemDataRole)
   virtual QVariant headerData(int theSection, Qt::Orientation theOrient, int theRole =
                                   Qt::DisplayRole) const;
 
+  /// Returns the number of rows under the given parent. When the parent is valid it means that 
+  /// rowCount is returning the number of children of parent.
+  /// \param theParent a parent model index
   virtual int rowCount(const QModelIndex& theParent = QModelIndex()) const;
+
+  /// Returns the number of columns for the children of the given parent.
+  /// It has a one column
+  /// \param theParent a parent model index
   virtual int columnCount(const QModelIndex& theParent = QModelIndex()) const;
 
-  virtual QModelIndex index(int theRow, int theColumn, const QModelIndex &parent =
+  /// Returns the index of the item in the model specified by the given row, column and parent index.
+  /// \param theRow a row
+  /// \param theColumn a column
+  /// \param theParent a parent model index
+  virtual QModelIndex index(int theRow, int theColumn, const QModelIndex &theParent =
                                 QModelIndex()) const;
 
+  /// Returns the parent of the model item with the given index. 
+  /// If the item has no parent, an invalid QModelIndex is returned.
+  /// \param theIndex a model index
   virtual QModelIndex parent(const QModelIndex& theIndex) const;
 
+  /// Returns true if parent has any children; otherwise returns false.
+  /// \param theParent a parent model index
   virtual bool hasChildren(const QModelIndex& theParent = QModelIndex()) const;
 
+  /// Inserts count rows into the model before the given row. 
+  /// Items in the new row will be children of the item represented by the parent model index.
+  /// \param theRow a start row
+  /// \param theCount a nember of rows to insert
+  /// \param theParent a parent model index
   bool insertRows(int theRow, int theCount, const QModelIndex& theParent = QModelIndex());
 
+  /// Removes count rows starting with the given row under parent parent from the model.
+  /// \param theRow a start row
+  /// \param theCount a nember of rows to remove
+  /// \param theParent a parent model index
   bool removeRows(int theRow, int theCount, const QModelIndex& theParent = QModelIndex());
 
+  /// Returns the item flags for the given index.
+  /// \param theIndex a model index
   Qt::ItemFlags flags(const QModelIndex& theIndex) const;
 
   //! Returns an object by the given Model index.
   //! Returns 0 if the given index is not index of an object
   ObjectPtr object(const QModelIndex& theIndex) const;
 
+  //! Returns index of the object
+  //! \param theObject object to find
   QModelIndex objectIndex(const ObjectPtr theObject) const;
 
   //! Returns QModelIndex which corresponds to the given part
   //! If the object is not found then index is not valid
+  //! \param thePart a part for analysis
   QModelIndex partIndex(const ResultPartPtr& thePart) const;
 
   //! Activates a part data model if the index is a Part node index. 
   //! Returns true if active part changed.
+  //! \param theIndex a model index
   bool activatedIndex(const QModelIndex& theIndex);
 
   //! Retrurns active part
@@ -78,6 +119,7 @@ Q_OBJECT
   //! Deactivates a Part
   void deactivatePart();
 
+  //! Rebuild data tree
   void rebuildDataTree();
 
   //! Clear internal data
index ab3b09a17231ae22e6cb01d5e5cd19600f6e52b8..266967988e30ac953518ffa2c47e704f02e3d26f 100644 (file)
@@ -17,12 +17,15 @@ class XGUI_Workshop;
 class XGUI_Displayer;
 
 /**
+ * \ingroup GUI
  * Implementation of IWorkshop interface which provides access to Workshop sevices at module level
  */
 class XGUI_EXPORT XGUI_ModuleConnector : public ModuleBase_IWorkshop
 {
 Q_OBJECT
  public:
+   /// Constructor
+   /// \param theWorkshop a workshop
   XGUI_ModuleConnector(XGUI_Workshop* theWorkshop);
 
   virtual ~XGUI_ModuleConnector();
@@ -59,9 +62,11 @@ Q_OBJECT
   //! If the list is empty then selection will be cleared
   virtual void setSelected(const QObjectPtrList& theFeatures);
 
+  //! Returns workshop
   XGUI_Workshop* workshop() const { return myWorkshop; }
 
 private:
+  /// Reference to workshop
   XGUI_Workshop* myWorkshop;
 
   /// A filter which provides selection within a current document or whole PartSet
index f5683f81aa5f4b3300397ac42b5a8ea8d9078e30..04505fed023b8cd29576f60dae71a8e308734a81 100644 (file)
@@ -63,6 +63,7 @@ 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);
 
   /// Start the operation and append it to the stack of operations
@@ -70,6 +71,7 @@ Q_OBJECT
   /// \return the state whether the current operation is started
   bool startOperation(ModuleBase_Operation* theOperation);
 
+  /// Abort all operations
   bool abortAllOperations();
 
   /// Returns whether the operation can be started. Check if there is already started operation and
@@ -133,15 +135,13 @@ signals:
 
   /// Commits the current operatin if it is valid
   bool commitOperation();
+
   /// Sets the current operation or NULL
   /// \param theOperation the started operation
-  /// \param isCheckBeforeStart the flag whether to check whether the operation can be started
-  /// \return the state whether the operation is resumed
   void resumeOperation(ModuleBase_Operation* theOperation);
 
  public slots:
   /// SLOT, that is called by the key in the property panel is clicked.
-  /// \param theName the attribute name
   /// \param theEvent the mouse event
   bool onKeyReleased(QKeyEvent* theEvent);
 
@@ -149,9 +149,17 @@ signals:
   /// 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
   void onOperationStarted();
+
+  /// Slot called on operation abort
   void onOperationAborted();
+
+  /// Slot called on operation commit
   void onOperationCommitted();
+
+  /// Slot called on operation resume
   void onOperationResumed();
 
  private:
index 4ef9cd58fe5e77611c73fb0f32d3fd04994183b1..56f28ad5e441a6d2229d9e4454e7751187c33bf6 100644 (file)
@@ -15,22 +15,50 @@ class XGUI_EXPORT XGUI_TopDataModel : public XGUI_FeaturesModel
 {
 Q_OBJECT
  public:
+   /// Constructor
+   /// \param theParent a parent object
   XGUI_TopDataModel(QObject* theParent);
   virtual ~XGUI_TopDataModel();
 
   // Reimpl from QAbstractItemModel
+
+  /// Returns the data stored under the given role for the item referred to by the index.
+  /// \param theIndex a model index
+  /// \param theRole a data role (see Qt::ItemDataRole)
   virtual QVariant data(const QModelIndex& theIndex, int theRole) const;
-  virtual QVariant headerData(int section, Qt::Orientation orientation,
-                              int role = Qt::DisplayRole) const;
 
-  virtual int rowCount(const QModelIndex &parent = QModelIndex()) const;
-  virtual int columnCount(const QModelIndex &parent = QModelIndex()) const;
+  /// Returns the data for the given role and section in the header with the specified orientation.
+  /// \param theSection a section
+  /// \param theOrient an orientation
+  /// \param theRole a data role (see Qt::ItemDataRole)
+  virtual QVariant headerData(int theSection, Qt::Orientation theOrient,
+                              int theRole = Qt::DisplayRole) const;
+
+  /// Returns the number of rows under the given parent. When the parent is valid it means that 
+  /// rowCount is returning the number of children of parent.
+  /// \param theParent a parent model index
+  virtual int rowCount(const QModelIndex &theParent = QModelIndex()) const;
+
+  /// Returns the number of columns for the children of the given parent.
+  /// It has a one column
+  /// \param theParent a parent model index
+  virtual int columnCount(const QModelIndex &theParent = QModelIndex()) const;
 
+
+  /// Returns the index of the item in the model specified by the given row, column and parent index.
+  /// \param theRow a row
+  /// \param theColumn a column
+  /// \param theParent a parent model index
   virtual QModelIndex index(int theRow, int theColumn, const QModelIndex& theParent =
                                 QModelIndex()) const;
 
+  /// Returns the parent of the model item with the given index. 
+  /// If the item has no parent, an invalid QModelIndex is returned.
+  /// \param theIndex a model index
   virtual QModelIndex parent(const QModelIndex& theIndex) const;
 
+  /// Returns true if parent has any children; otherwise returns false.
+  /// \param theParent a parent model index
   virtual bool hasChildren(const QModelIndex& theParent = QModelIndex()) const;
 
   //! Returns object by the given Model index.
@@ -70,22 +98,49 @@ class XGUI_PartDataModel : public XGUI_PartModel
 {
 Q_OBJECT
  public:
+   /// Constructor
+   /// \param theParent a parent object
   XGUI_PartDataModel(QObject* theParent);
   virtual ~XGUI_PartDataModel();
 
   // Reimpl from QAbstractItemModel
-  virtual QVariant data(const QModelIndex& theIndex, int theRole) const;
-  virtual QVariant headerData(int section, Qt::Orientation orientation,
-                              int role = Qt::DisplayRole) const;
 
-  virtual int rowCount(const QModelIndex &parent = QModelIndex()) const;
-  virtual int columnCount(const QModelIndex &parent = QModelIndex()) const;
+  /// Returns the data stored under the given role for the item referred to by the index.
+  /// \param theIndex a model index
+  /// \param theRole a data role (see Qt::ItemDataRole)
+  virtual QVariant data(const QModelIndex& theIndex, int theRole) const;
 
+  /// Returns the data for the given role and section in the header with the specified orientation.
+  /// \param theSection a section
+  /// \param theOrient an orientation
+  /// \param theRole a data role (see Qt::ItemDataRole)
+  virtual QVariant headerData(int theSection, Qt::Orientation theOrient,
+                              int theRole = Qt::DisplayRole) const;
+
+  /// Returns the number of rows under the given parent. When the parent is valid it means that 
+  /// rowCount is returning the number of children of parent.
+  /// \param theParent a parent model index
+  virtual int rowCount(const QModelIndex &theParent = QModelIndex()) const;
+
+  /// Returns the number of columns for the children of the given parent.
+  /// It has a one column
+  /// \param theParent a parent model index
+  virtual int columnCount(const QModelIndex &theParent = QModelIndex()) const;
+
+  /// Returns the index of the item in the model specified by the given row, column and parent index.
+  /// \param theRow a row
+  /// \param theColumn a column
+  /// \param theParent a parent model index
   virtual QModelIndex index(int theRow, int theColumn, const QModelIndex& theParent =
                                 QModelIndex()) const;
 
+  /// Returns the parent of the model item with the given index. 
+  /// If the item has no parent, an invalid QModelIndex is returned.
+  /// \param theIndex a model index
   virtual QModelIndex parent(const QModelIndex& theIndex) const;
 
+  /// Returns true if parent has any children; otherwise returns false.
+  /// \param theParent a parent model index
   virtual bool hasChildren(const QModelIndex& theParent = QModelIndex()) const;
 
   //! Returns object by the given Model index.
@@ -113,6 +168,7 @@ Q_OBJECT
   //! Returns document of the current part
   DocumentPtr partDocument() const;
 
+  //! Returns defult number of rows
   int getRowsNumber() const;
 
   //! Types of QModelIndexes
index f7c2211bd55ed05edc29c1240105d9c865c67350..6cd29e8704305131b9f6f7c9660d4686a4690574 100644 (file)
@@ -24,6 +24,7 @@
 class XGUI_EXPORT PostponeMessageQtEvent : public QEvent
 {
  public:
+   /// An event type
   static QEvent::Type PostponeMessageQtEventType;
 
   /// Constructor
index 13ce80b05e6d4a02fd35c260a1ddc226ca9bf140..e67078e905aa3c1f81213e2171fa1a88c88d7f14 100644 (file)
@@ -85,6 +85,7 @@ class XGUI_EXPORT XGUI_SalomeConnector
   //! Returns interface to Salome viewer
   virtual ModuleBase_IViewer* viewer() const = 0;
 
+  //! Create preferences
   virtual void createPreferences() = 0;
 };
 
index 6503f175d93b27fa53d1f694b89d6929837d4b5f..98755ea20078afe8f50a0c7a001a35100a837376 100644 (file)
@@ -26,9 +26,12 @@ class XGUI_EXPORT XGUI_SelectionMgr : public QObject
 {
 Q_OBJECT
  public:
+   /// Constructor
+   /// \param theParent a parent workshop
   XGUI_SelectionMgr(XGUI_Workshop* theParent);
   virtual ~XGUI_SelectionMgr();
 
+  /// Returns current selection
   XGUI_Selection* selection() const
   {
     return mySelection;
@@ -52,11 +55,17 @@ signals:
   void selectionChanged();
 
  private slots:
+   /// Reaction on selectio0n in Object browser
   void onObjectBrowserSelection();
+
+   /// Reaction on selectio0n in Viewer
   void onViewerSelection();
 
  private:
+   /// Reference to workshop
   XGUI_Workshop* myWorkshop;
+
+  /// Current selection object
   XGUI_Selection* mySelection;
 };
 
index 614b2be23ca15f8ac8b5e0fc79f195bbacd9aec6..9ea32e03ebb6bee6e06b97adbdc3b28c64345e00 100644 (file)
  \return directory part of the file path
  */
 namespace XGUI_Tools {
+
+/**
+* Returns directory name from name of file
+* \param path a path to a file
+* \param isAbs is absolute or relative path
+*/
 QString XGUI_EXPORT dir(const QString& path, bool isAbs = true);
 
 /*!
index 7cd1f90d6e7b8e3bb9bb439d1962a33ef6b446de..d882b47919c81d6ab64f5ef7bd48022d6a7c7b2d 100644 (file)
@@ -19,6 +19,8 @@ class XGUI_EXPORT XGUI_ViewerProxy : public ModuleBase_IViewer
 {
 Q_OBJECT
  public:
+   /// Constructor
+   /// \param theParent a parent object
   XGUI_ViewerProxy(XGUI_Workshop* theParent);
 
   //! Returns AIS_InteractiveContext from current OCCViewer
index 7b234a365de7ce5416e7f0a0d24af7a410d6e226..43f8e9f83b66c7c86331fdc6caacc3909def4cfe 100644 (file)
@@ -1245,17 +1245,17 @@ void XGUI_Workshop::activatePart(ResultPartPtr theFeature)
 }
 
 //**************************************************************
-void XGUI_Workshop::activateLastPart()
-{
-  SessionPtr aMgr = ModelAPI_Session::get();
-  DocumentPtr aDoc = aMgr->moduleDocument();
-  std::string aGrpName = ModelAPI_ResultPart::group();
-  ObjectPtr aLastPart = aDoc->object(aGrpName, aDoc->size(aGrpName) - 1);
-  ResultPartPtr aPart = std::dynamic_pointer_cast<ModelAPI_ResultPart>(aLastPart);
-  if (aPart) {
-    activatePart(aPart);
-  }
-}
+//void XGUI_Workshop::activateLastPart()
+//{
+//  SessionPtr aMgr = ModelAPI_Session::get();
+//  DocumentPtr aDoc = aMgr->moduleDocument();
+//  std::string aGrpName = ModelAPI_ResultPart::group();
+//  ObjectPtr aLastPart = aDoc->object(aGrpName, aDoc->size(aGrpName) - 1);
+//  ResultPartPtr aPart = std::dynamic_pointer_cast<ModelAPI_ResultPart>(aLastPart);
+//  if (aPart) {
+//    activatePart(aPart);
+//  }
+//}
 
 //**************************************************************
 void XGUI_Workshop::deleteObjects(const QObjectPtrList& theList)
index 13fa9039e7678785499ee88cc36efd7260f9558a..34ce06b91568e4483d9c0d03e458429d644d9bd4 100644 (file)
@@ -55,7 +55,9 @@ class XGUI_EXPORT XGUI_Workshop : public QObject, public Events_Listener
 {
 Q_OBJECT
  public:
-
+  /// Constructor
+  /// \param theConnector a Salome connector object. 
+  /// Used only if the workshop is launched in Salome environment
   XGUI_Workshop(XGUI_SalomeConnector* theConnector = 0);
   virtual ~XGUI_Workshop();
 
@@ -131,8 +133,10 @@ Q_OBJECT
     return myObjectBrowser;
   }
 
+  /// This method is called by Salome module when selection is changed
   void salomeViewerSelectionChanged();
 
+  /// Returns viewer which unifies access as to Salome viewer as to standalone viewer
   XGUI_ViewerProxy* viewer() const
   {
     return myViewerProxy;
@@ -161,8 +165,12 @@ Q_OBJECT
   //! Show the given features in 3d Viewer
   void showOnlyObjects(const QObjectPtrList& theList);
 
+  /// Set display mode for the given onjects
+  /// \param theList a list of displayed objects
+  /// \param theMode a mode to set (see \ref XGUI_Displayer)
   void setDisplayMode(const QObjectPtrList& theList, int theMode);
 
+  /// Returns current module
   ModuleBase_IModule* module() const
   {
     return myModule;
@@ -181,7 +189,7 @@ Q_OBJECT
   */
   void saveDocument(const QString& theName, std::list<std::string>& theFileNames);
 
-  /*
+  /**
    * If there is an active (uncommited) operation shows a prompt to abort it
    * and performs abortion if user agreed. Returns true if
    * - operation aborted successfully
@@ -190,8 +198,12 @@ Q_OBJECT
   bool isActiveOperationAborted();
 
 signals:
+  /// Emitted when selection happens in Salome viewer
   void salomeViewerSelection();
+
+  /// Emitted when error in applivation happens
   void errorOccurred(const QString&);
+
   //! the signal about the workshop actions states are updated.
   void commandStatusUpdated();
 
@@ -199,53 +211,102 @@ signals:
   void applicationStarted();
 
  public slots:
+   /// Update of commands status
   void updateCommandStatus();
 
+  /// Create a new dokument
   void onNew();
+
+  /// Open document from file
   void onOpen();
+
+  /// Save current document
   bool onSave();
+
+  /// Save current document to a file selected by user
   bool onSaveAs();
+
+  /// Exit application
   void onExit();
+
+  /// Undo last command
   void onUndo();
+
+  /// Redo previous command
   void onRedo();
+
+  /// Rebuild data tree
   void onRebuild();
+
+  /// Open preferences dialog box
   void onPreferences();
 
+  /// Show property panel
   void showPropertyPanel();
+
+  /// Hide property panel
   void hidePropertyPanel();
+
+  /// Show object Browser
   void showObjectBrowser();
+
+  /// Hide object Browser
   void hideObjectBrowser();
 
+  /// Reaction on command call
   void onFeatureTriggered();
+
+  /// Change active document
+  /// \param theObj a part object. If it is NULL then active document is a main document
   void changeCurrentDocument(ObjectPtr theObj);
 
-  void activateLastPart();
+  //void activateLastPart();
 
+  /// Close document
   void closeDocument();
 
  protected:
-  // Find the nested features and set them into the operation
-  // \param theOperation an operation
+  /// Find the nested features and set them into the operation
+  /// \param theOperation an operation
   void setNestedFeatures(ModuleBase_Operation* theOperation);
-  // Update the property panel content by the XML description of the operation and set the panel
-  // into the operation
-  // \param theOperation an operation
+
+  /// Update the property panel content by the XML description of the operation and set the panel
+  /// into the operation
+  /// \param theOperation an operation
   void setPropertyPanel(ModuleBase_Operation* theOperation);
 
+  /// Procedure to process postponed events
   bool event(QEvent * theEvent);
+
   //Event-loop processing methods:
+
+  /// Process event "Add a feature"
   void addFeature(const std::shared_ptr<Config_FeatureMessage>&);
+
+  /// Connect to operation signals
+  /// \param theOperation an operation
   void connectWithOperation(ModuleBase_Operation* theOperation);
 
-  void onFeatureUpdatedMsg(const std::shared_ptr<ModelAPI_ObjectUpdatedMessage>& theMsg);
-  void onFeatureCreatedMsg(const std::shared_ptr<ModelAPI_ObjectUpdatedMessage>& theMsg);
-  void onFeatureRedisplayMsg(const std::shared_ptr<ModelAPI_ObjectUpdatedMessage>& theMsg);
-  void onObjectDeletedMsg(const std::shared_ptr<ModelAPI_ObjectDeletedMessage>& theMsg);
+  /// Process feature update message
+  void onFeatureUpdatedMsg(const std::shared_ptr<ModelAPI_ObjectUpdatedMessage>& );
 
-  void validateOperation(const QString& theOperationId);
+  ///Process feature created message
+  void onFeatureCreatedMsg(const std::shared_ptr<ModelAPI_ObjectUpdatedMessage>& );
 
+  /// Process feature redisplay message
+  void onFeatureRedisplayMsg(const std::shared_ptr<ModelAPI_ObjectUpdatedMessage>& );
+
+  /// Process feature delete message
+  void onObjectDeletedMsg(const std::shared_ptr<ModelAPI_ObjectDeletedMessage>& );
+
+  /// Display all results
   void displayAllResults();
+
+  /// Displau results from document
+  /// \param theDoc a document
   void displayDocumentResults(DocumentPtr theDoc);
+
+  /// Display results from a group
   void displayGroupResults(DocumentPtr theDoc, std::string theGroup);
 
  private slots:
@@ -272,21 +333,37 @@ signals:
   /// \param theOpertion an aborted operation
   void onOperationAborted(ModuleBase_Operation* theOperation);
 
+  /// Process context menu command
+  /// \param theId id of the command
+  /// \param isChecked is checked flag
   void onContextMenuCommand(const QString& theId, bool isChecked);
 
+  /// Processing of values changed in model widget
   void onWidgetValuesChanged();
 
+  /// Set waiting cursor
   void onStartWaiting();
 
  private:
+   /// Init menu
   void initMenu();
 
+  /// Register validators
   void registerValidators() const;
 
+  /// Load module from external library
+  /// \param theModule name of the module
   ModuleBase_IModule* loadModule(const QString& theModule);
+
+  /// Activate module
   bool activateModule();
 
+  /// Create object browser widget
+  /// \param theParent a parent of widget
   QDockWidget* createObjectBrowser(QWidget* theParent);
+
+  /// Create property panel widget
+  /// \param theParent a parent of widget
   QDockWidget* createPropertyPanel(QWidget* theParent);
 
   // Creates Dock widgets: Object browser and Property panel