X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FConfig%2FConfig_FeatureMessage.h;h=98201cf6f57d9c57f7349da91266acca706828d9;hb=592b8a38b3c9e2a6a7d3d1d180b1f9b5406c4415;hp=2613c992636fef61ddaeade5dafdb19730a76638;hpb=587c5c1821f464e323eec057ba860b2433d4f412;p=modules%2Fshaper.git

diff --git a/src/Config/Config_FeatureMessage.h b/src/Config/Config_FeatureMessage.h
index 2613c9926..98201cf6f 100644
--- a/src/Config/Config_FeatureMessage.h
+++ b/src/Config/Config_FeatureMessage.h
@@ -1,3 +1,5 @@
+// Copyright (C) 2014-20xx CEA/DEN, EDF R&D
+
 #ifndef CONFIG_MESSAGE_H
 #define CONFIG_MESSAGE_H
 
@@ -6,58 +8,105 @@
 
 #include <string>
 
-/// Event ID that feature is loaded (comes with Config_FeatureMessage)
-static const char * EVENT_FEATURE_LOADED = "FeatureLoaded";
-
-/*
- * Class to pass a feature entry extracted from xml file.
+/*!
+ * \class Config_FeatureMessage
+ * \ingroup Config
+ * \brief Class to pass a feature entry extracted from xml file.
  * Example of the feature entry:
+ * \code
  * <feature id="Part" text="New part" tooltip="Creates a new part" icon=":pictures/part_ico.png"/>
+ * \endcode
  */
-class Config_FeatureMessage: public Events_Message
+class Config_FeatureMessage : public Events_Message
 {
-  std::string myId;  //Feature unique id
-  std::string myText; //Represents action's text
-  std::string myTooltip;  //Represents action's tooltip
-  std::string myIcon; //Represents action's icon
-  std::string myKeysequence;  //Represents action's key sequence
+  std::string myId;  ///<Feature unique id
+  std::string myText;  ///<Represents action's text
+  std::string myTooltip;  ///<Represents action's tooltip
+  std::string myIcon;  ///<Represents action's icon
+  std::string myKeysequence;  ///<Represents action's key sequence
 
-  std::string myGroupId;  //Id of feature's group
-  std::string myWorkbenchId;  //Id of feature's workbench
-  std::string myPluginLibrary;  //Name of feature's library
+  std::string myGroupId;  ///<Id of feature's group
+  std::string myWorkbenchId;  ///<Id of feature's workbench
+  std::string myDocumentKind;  ///< kind of the document of the workbench (all documents if empty)
+  std::string myPluginLibrary;  ///<Name of feature's library
 
-  bool myUseInput; //Action is being checked until user commit the operation
-  bool myInternal; //Internal feature without GUI representation
-  std::string myNestedFeatures;
+  bool myUseInput;  ///<Action is being checked until user commit the operation
+  bool myInternal;  ///<Internal feature without GUI representation
+  std::string myNestedFeatures; ///<Space separated list of child features
+  std::string myActionsWhenNested; ///<Space separated list of actions
 
-public:
-  //const Events_ID theID, const void* theSender = 0
+ public:
+  /// Event ID that feature is loaded in workbench (GUI)
+  inline static const char* GUI_EVENT()
+  {
+    static const char * MY_GUI_EVENT_ID("WorkshopFeatureLoaded");
+    return MY_GUI_EVENT_ID;
+  }
+  /// Event ID that feature is loaded in workbench (Model)
+  inline static const char* MODEL_EVENT()
+  {
+    static const char * MY_MODEL_EVENT_ID("ModelFeatureLoaded");
+    return MY_MODEL_EVENT_ID;
+  }
+
+  /// Constructs Config_FeatureMessage
   CONFIG_EXPORT Config_FeatureMessage(const Events_ID theId, const void* theParent = 0);
+  /// Deletes Config_FeatureMessage
+  CONFIG_EXPORT virtual ~Config_FeatureMessage();
 
   //Auto-generated getters/setters
-  CONFIG_EXPORT const std::string& icon() const;
+  /// Feature's Id
   CONFIG_EXPORT const std::string& id() const;
+  /// Feature's Icon
+  CONFIG_EXPORT const std::string& icon() const;
+  /// Feature's shortcut
   CONFIG_EXPORT const std::string& keysequence() const;
+  /// Feature's text
   CONFIG_EXPORT const std::string& text() const;
+  /// Feature's tooltip
   CONFIG_EXPORT const std::string& tooltip() const;
-
+  /// Id of Feature's Group
   CONFIG_EXPORT const std::string& groupId() const;
+  /// Id of Feature's Workbench
   CONFIG_EXPORT const std::string& workbenchId() const;
+  /// Kind of a document which contains the feature
+  CONFIG_EXPORT const std::string& documentKind() const;
+  /// Name of a library which contains the feature
   CONFIG_EXPORT const std::string& pluginLibrary() const;
+  /// Space separated list of nested features
   CONFIG_EXPORT const std::string& nestedFeatures() const;
+  /// Space separated list of actions
+  CONFIG_EXPORT const std::string& actionsWhenNested() const;
+  /// If false - feature has no Property panel representation
   CONFIG_EXPORT bool isUseInput() const;
+  /// If true - feature will not be added into the workbench
   CONFIG_EXPORT bool isInternal() const;
 
-  CONFIG_EXPORT void setIcon(const std::string& icon);
+  ///Set feature's Id
   CONFIG_EXPORT void setId(const std::string& id);
+  ///Set feature's Icon
+  CONFIG_EXPORT void setIcon(const std::string& icon);
+  ///Set feature's shortcut
   CONFIG_EXPORT void setKeysequence(const std::string& keysequence);
+  ///Set feature's text
   CONFIG_EXPORT void setText(const std::string& text);
+  ///Set feature's tooltip
   CONFIG_EXPORT void setTooltip(const std::string& tooltip);
+  ///Set id of Feature's Group
   CONFIG_EXPORT void setGroupId(const std::string& groupId);
+  ///Set id of Feature's Workbench
   CONFIG_EXPORT void setWorkbenchId(const std::string& workbenchId);
+  ///Set kind of a document which contains the feature
+  CONFIG_EXPORT void setDocumentKind(const std::string& documentKind);
+  ///Set name of a library which contains the feature
   CONFIG_EXPORT void setPluginLibrary(const std::string& thePluginLibrary);
+  ///Set space separated list of nested features
   CONFIG_EXPORT void setNestedFeatures(const std::string& theNestedFeatures);
+  ///Set space separated list of nested features
+  CONFIG_EXPORT void setActionsWhenNested(const std::string& theActions);
+  ///Set use input state; If false - feature has no Property panel representation
   CONFIG_EXPORT void setUseInput(bool isUseInput);
+  ///Set internal state; If true - feature will not be added into the workbench
   CONFIG_EXPORT void setInternal(bool isInternal);
 };