src/ModelAPI/ModelAPI_Feature.h

   1 // File:        ModelAPI_Feature.hxx
   2 // Created:     21 Mar 2014
   3 // Author:      Mikhail PONIKAROV
   4
   5 #ifndef ModelAPI_Feature_HeaderFile
   6 #define ModelAPI_Feature_HeaderFile
   7
   8 #include "ModelAPI.h"
   9 #include "ModelAPI_PluginManager.h"
  10
  11 #include <string>
  12 #include <boost/shared_ptr.hpp>
  13
  14 class ModelAPI_Data;
  15 class ModelAPI_Document;
  16
  17 /**\class ModelAPI_Feature
  18  * \ingroup DataModel
  19  * \brief Functionality of the model object: to update result,
  20  * to initialize attributes, etc.
  21  */
  22 class ModelAPI_Feature
  23 {
  24   boost::shared_ptr<ModelAPI_Data> myData; ///< manager of the data model of a feature
  25   boost::shared_ptr<ModelAPI_Document> myDoc; ///< document this feature belongs to
  26
  27 public:
  28   /// Returns the kind of a feature (like "Point")
  29   MODELAPI_EXPORT virtual const std::string& getKind() = 0;
  30
  31   /// Returns to which group in the document must be added feature
  32   MODELAPI_EXPORT virtual const std::string& getGroup() = 0;
  33
  34   /// Request for initialization of data model of the feature: adding all attributes
  35   MODELAPI_EXPORT virtual void initAttributes() = 0;
  36
  37   /// Computes or recomputes the result
  38   MODELAPI_EXPORT virtual void execute() = 0;
  39
  40   /// Returns true if this feature must be displayed in the history (top level of Part tree)
  41   MODELAPI_EXPORT virtual bool isInHistory() {return true;}
  42
  43   /// Returns the data manager of this feature
  44   MODELAPI_EXPORT virtual boost::shared_ptr<ModelAPI_Data> data() {return myData;}
  45
  46   /// Must return document where the new feature must be added to
  47   /// By default it is current document
  48   MODELAPI_EXPORT virtual boost::shared_ptr<ModelAPI_Document> documentToAdd()
  49   {return ModelAPI_PluginManager::get()->currentDocument();}
  50
  51   /// Returns document this feature belongs to
  52   MODELAPI_EXPORT virtual boost::shared_ptr<ModelAPI_Document> document()
  53   {return myDoc;}
  54
  55   /// To virtually destroy the fields of successors
  56   virtual ~ModelAPI_Feature() {}
  57
  58 protected:
  59   /// Use plugin manager for features creation: this method is
  60   /// defined here only for SWIG-wrapping
  61   ModelAPI_Feature()
  62   {}
  63
  64   /// Sets the data manager of an object (document does)
  65   MODELAPI_EXPORT void setData(boost::shared_ptr<ModelAPI_Data> theData) {myData = theData;}
  66   /// Sets the data manager of an object (document does)
  67   MODELAPI_EXPORT void setDoc(boost::shared_ptr<ModelAPI_Document> theDoc) {myDoc = theDoc;}
  68
  69   friend class Model_Document;
  70 };
  71
  72 #endif