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 the data manager of this feature
  41   MODELAPI_EXPORT virtual boost::shared_ptr<ModelAPI_Data> data() {return myData;}
  42
  43   /// Must return document where the new feature must be added to
  44   /// By default it is current document
  45   MODELAPI_EXPORT virtual boost::shared_ptr<ModelAPI_Document> documentToAdd()
  46   {return ModelAPI_PluginManager::get()->currentDocument();}
  47
  48   /// Returns document this feature belongs to
  49   MODELAPI_EXPORT virtual boost::shared_ptr<ModelAPI_Document> document()
  50   {return myDoc;}
  51
  52   /// To virtually destroy the fields of successors
  53   virtual ~ModelAPI_Feature() {}
  54
  55 protected:
  56   /// Use plugin manager for features creation: this method is
  57   /// defined here only for SWIG-wrapping
  58   ModelAPI_Feature()
  59   {}
  60
  61   /// Sets the data manager of an object (document does)
  62   MODELAPI_EXPORT void setData(boost::shared_ptr<ModelAPI_Data> theData) {myData = theData;}
  63   /// Sets the data manager of an object (document does)
  64   MODELAPI_EXPORT void setDoc(boost::shared_ptr<ModelAPI_Document> theDoc) {myDoc = theDoc;}
  65
  66   friend class Model_Document;
  67 };
  68
  69 #endif