X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FModelAPI%2FModelAPI_Feature.h;h=71bd251d8802d78f6717193f34659fa367ddac7a;hb=38dd97c8f7a3605ec6c362c3aefdefa3ee2675be;hp=9f989074b57cccc560b49814218b7ef6d51ee945;hpb=96ff1d1fb2acb842cee193f15492de81060a1d58;p=modules%2Fshaper.git diff --git a/src/ModelAPI/ModelAPI_Feature.h b/src/ModelAPI/ModelAPI_Feature.h index 9f989074b..71bd251d8 100644 --- a/src/ModelAPI/ModelAPI_Feature.h +++ b/src/ModelAPI/ModelAPI_Feature.h @@ -1,3 +1,5 @@ +// Copyright (C) 2014-20xx CEA/DEN, EDF R&D + // File: ModelAPI_Feature.hxx // Created: 21 Mar 2014 // Author: Mikhail PONIKAROV @@ -5,16 +7,15 @@ #ifndef ModelAPI_Feature_H_ #define ModelAPI_Feature_H_ -#include "ModelAPI_Object.h" -#include "ModelAPI_PluginManager.h" +#include +#include +#include +#include -#include -#include -#include +#include -class ModelAPI_Data; -class ModelAPI_Document; -class ModelAPI_Result; +#include +#include /**\class ModelAPI_Feature * \ingroup DataModel @@ -24,50 +25,217 @@ class ModelAPI_Result; class ModelAPI_Feature : public ModelAPI_Object { ///< list of current results of this feature - std::list > myResults; -public: + std::list > myResults; + ///< is feature disabled or not + bool myIsDisabled; + ///< is feature is stable (not editing) + bool myIsStable; + + public: /// Returns the unique kind of a feature (like "Point") virtual const std::string& getKind() = 0; /// Returns the group identifier of all features - static std::string group() - {static std::string MY_GROUP = "Features"; return MY_GROUP;} + inline static std::string group() + { + static std::string MY_GROUP = "Features"; + return MY_GROUP; + } + + /// Returns document this feature belongs to + virtual std::shared_ptr document() const + { + return ModelAPI_Object::document(); + } /// Returns the group identifier of this result - virtual std::string groupName() { return group(); } - - /// Request for initialization of data model of the feature: adding all attributes - virtual void initAttributes() = 0; + virtual std::string groupName() + { + return group(); + } /// Computes or recomputes the results virtual void execute() = 0; + /// Computes the attribute value on the base of other attributes if the value can be computed + /// \param theAttributeId an attribute index to be computed + /// \return a boolean value about it is computed + virtual bool compute(const std::string& theAttributeId) { return false; }; + + /// Registers error during the execution, causes the ExecutionFailed state + MODELAPI_EXPORT virtual void setError(const std::string& theError, + bool isSend = true, + bool isTranslate = true); + + /// Returns error, arose during the execution + virtual std::string error() const { + return data()->error(); + } + /// returns the current results of the feature - MODELAPI_EXPORT const std::list >& results(); + MODELAPI_EXPORT const std::list >& results(); /// returns the first result in the list or NULL reference - MODELAPI_EXPORT boost::shared_ptr firstResult(); + MODELAPI_EXPORT std::shared_ptr firstResult() const; + /// returns the last result in the list or NULL reference + MODELAPI_EXPORT std::shared_ptr lastResult(); /// sets the alone result - MODELAPI_EXPORT void setResult(const boost::shared_ptr& theResult); + MODELAPI_EXPORT void setResult(const std::shared_ptr& theResult); /// sets the result by index (zero based), results before this must be set before - MODELAPI_EXPORT void setResult( - const boost::shared_ptr& theResult, const int theIndex); + MODELAPI_EXPORT void setResult(const std::shared_ptr& theResult, + const int theIndex); + /// removes the result from the feature + MODELAPI_EXPORT void removeResult(const std::shared_ptr& theResult); + /// removes all results starting from the given index (zero-based) + /// \param theSinceIndex - index of the deleted result and all after also will be deleted + /// \param theFlush - if it is false, REDISPLAY message is not flushed + MODELAPI_EXPORT void removeResults(const int theSinceIndex, const bool theFlush = true); + /// removes all results from the feature + MODELAPI_EXPORT void eraseResults(); + /// removes all fields from this feature: results, data, etc + MODELAPI_EXPORT virtual void erase(); + /// removes the result from the list of feature (not doing in disabled): normally this + /// method is not used from features. only internally + MODELAPI_EXPORT void eraseResultFromList(const std::shared_ptr& theResult); + + /// Returns true if result is persistent (stored in document) and on undo-redo, save-open + /// it is not needed to recompute it. + virtual bool isPersistentResult() {return true;} /// Returns true if this feature must not be created: this is just an action /// that is not stored in the features history and data model (like "delete part"). - virtual bool isAction() {return false;} + virtual bool isAction() + { + return false; + } + + /// Returns true if this feature is used as macro: creates other features and then removed. + /// \returns false by default + MODELAPI_EXPORT virtual bool isMacro() const; + + /// Returns true if preview update during the edition needed. Otherwise the update-mechanism + /// calls the \a execute function only on "apply" of the operation + /// \returns true by default + MODELAPI_EXPORT virtual bool isPreviewNeeded() const; /// Must return document where the new feature must be added to - /// By default it is current document - MODELAPI_EXPORT virtual boost::shared_ptr documentToAdd(); + /// By default it is empty: it is added to the document this method is called to + MODELAPI_EXPORT virtual const std::string& documentToAdd(); + + /// Enables/disables the feature. The disabled feature has no results and does not participate in + /// any calculation. + /// \returns true if state is really changed + MODELAPI_EXPORT virtual bool setDisabled(const bool theFlag); + + /// Returns the feature is disabled or not. + MODELAPI_EXPORT virtual bool isDisabled(); /// To virtually destroy the fields of successors MODELAPI_EXPORT virtual ~ModelAPI_Feature(); - MODELAPI_EXPORT static boost::shared_ptr feature(ObjectPtr theObject); - + /// Returns the feature by the object (result). + MODELAPI_EXPORT static std::shared_ptr feature(ObjectPtr theObject); + + /// Set the stable feature flag. If feature is currently editing then it is not stable. + /// \returns true if state is really changed + MODELAPI_EXPORT virtual bool setStable(const bool theFlag); + + /// Returns the feature is stable or not. + MODELAPI_EXPORT virtual bool isStable(); + + /// Performs some custom feature specific functionality (normally called by some GUI button) + /// \param theActionId an action key + /// \return a boolean value about it is performed + MODELAPI_EXPORT virtual bool customAction(const std::string& theActionId); + + // + // Helper methods, aliases for data()->method() + // ----------------------------------------------------------------------------------------------- + /// Returns the name stored in the attribute + inline std::string name() + { + return data()->name(); + } + /// Returns the Boolean attribute by the identifier + inline std::shared_ptr boolean(const std::string& theID) + { + return data()->boolean(theID); + } + /// Returns the document reference attribute + inline std::shared_ptr document(const std::string& theID) + { + return data()->document(theID); + } + /// Returns the real attribute by the identifier + inline std::shared_ptr real(const std::string& theID) + { + return data()->real(theID); + } + /// Returns the integer attribute by the identifier + inline std::shared_ptr integer(const std::string& theID) + { + return data()->integer(theID); + } + /// Returns the integer array attribute by the identifier + inline std::shared_ptr intArray(const std::string& theID) + { + return data()->intArray(theID); + } + /// Returns the reference attribute by the identifier + inline std::shared_ptr refattr(const std::string& theID) + { + return data()->refattr(theID); + } + /// Returns the reference attribute by the identifier + inline std::shared_ptr reference(const std::string& theID) + { + return data()->reference(theID); + } + /// Returns the list of references attribute by the identifier + inline std::shared_ptr reflist(const std::string& theID) + { + return data()->reflist(theID); + } + /// Returns the shape selection attribute by the identifier + inline std::shared_ptr selection(const std::string& theID) + { + return data()->selection(theID); + } + /// Returns the list of shape selections attribute by the identifier + inline std::shared_ptr selectionList(const std::string& theID) + { + return data()->selectionList(theID); + } + /// Returns the string attribute by the identifier + inline std::shared_ptr string(const std::string& theID) + { + return data()->string(theID); + } + /// Returns the string array attribute by the identifier + inline std::shared_ptr stringArray(const std::string& theID) + { + return data()->stringArray(theID); + } + /// Returns the tables attribute by the identifier + inline std::shared_ptr tables(const std::string& theID) + { + return data()->tables(theID); + } + /// Returns the attribute by the identifier + inline std::shared_ptr attribute(const std::string& theID) + { + return data()->attribute(theID); + } + protected: + /// This method is called just after creation of the object: it must initialize + /// all fields, normally initialized in the constructor + MODELAPI_EXPORT virtual void init(); + + friend class Model_Document; + friend class Model_Objects; }; //! Pointer on feature object -typedef boost::shared_ptr FeaturePtr; +typedef std::shared_ptr FeaturePtr; #endif +