X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;ds=inline;f=src%2FConfig%2FConfig_WidgetAPI.h;h=e9531e49fb7af27c9615c666c2e172a0a7af2df9;hb=e377b63872e923d11c1832e1d4804b3d66b9d560;hp=2c2cd9c7165015879a397dc73dceac73e74aa717;hpb=3828ae57873e6bda6ff760b85172bd439d1b4483;p=modules%2Fshaper.git

diff --git a/src/Config/Config_WidgetAPI.h b/src/Config/Config_WidgetAPI.h
index 2c2cd9c71..e9531e49f 100644
--- a/src/Config/Config_WidgetAPI.h
+++ b/src/Config/Config_WidgetAPI.h
@@ -29,6 +29,7 @@ struct _xmlDoc;
 
 /*!
  * \class Config_WidgetAPI
+ * \ingroup Config
  * \brief Provides low-level API for WidgetFactory for reading xml definitions of widgets
  */
 class CONFIG_EXPORT Config_WidgetAPI
@@ -36,37 +37,47 @@ class CONFIG_EXPORT Config_WidgetAPI
  public:
   virtual ~Config_WidgetAPI();
 
+  //! Returns name of widget's node (attribute)
   std::string widgetType() const;
-  bool isContainerWidget() const;
+  //! Returns true if widget has container type, which means it able to contain other widgets
+  bool isGroupBoxWidget() const;
+  //! Returns true if widget has page type;
+  //! Page is container widget with combo box control to switch between pages
   bool isPagedWidget() const;
 
+  //! Returns id of current widget
   std::string widgetId() const;
+  //! Returns icon of current widget
   std::string widgetIcon() const;
+  //! Returns text for label of current widget
   std::string widgetLabel() const;
+  //! Returns text for tooltip of current widget
   std::string widgetTooltip() const;
-
+  //! Returns a custom property of current widget
   std::string getProperty(const char* thePropName) const;
 
-  /// Checks if the XML representation of widget has given attribute,
-  /// if yes - returns it's bool value, if no, or if the value can not
-  /// be converted to bool - returns theDefault.
-  /// \param theAttributeName attribute to check
-  /// \param theDefault default value on bad data
-  /// \return the boolean result
+  /*! Checks if the XML representation of widget has given attribute,
+   *  if yes - returns it's bool value, if no, or if the value can not
+   *  be converted to bool - returns theDefault.
+   *  \param theAttributeName attribute to check
+   *  \param theDefault default value on bad data
+   *  \return the boolean result
+   */
   bool getBooleanAttribute(const char* theAttributeName, bool theDefault) const;
 
-  bool isComputedDefault() const;
-
  protected:
   /// These fields are accessible for ModuleBase_WidgetFactory only
   Config_WidgetAPI(std::string theRawXml);
+  //! Pass to the next (sibling) node of widget's xml definition. If impossible, returns false
   bool toNextWidget();
+  //! Pass into the child node of widget's xml definition. If impossible, returns false
   bool toChildWidget();
+  //! Pass into the parent node of widget's xml definition. If impossible, returns false
   bool toParentWidget();
 
  private:
-  xmlDocPtr myDoc;
-  xmlNodePtr myCurrentNode;
+  xmlDocPtr myDoc; //!< Pointer to the root of widget's xml definition
+  xmlNodePtr myCurrentNode; //!< Pointer to the current node in the widget's xml definition
 
   friend class ModuleBase_WidgetFactory;
 };