-// Copyright (C) 2014-2017 CEA/DEN, EDF R&D
+// Copyright (C) 2014-2024 CEA, EDF
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
-// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
//
-// See http://www.salome-platform.org/ or
-// email : webmaster.salome@opencascade.com<mailto:webmaster.salome@opencascade.com>
+// See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
//
#ifndef Model_Data_H_
#include <ModelAPI_AttributeString.h>
#include <ModelAPI_AttributeStringArray.h>
#include <ModelAPI_AttributeIntArray.h>
+#include <ModelAPI_AttributeImage.h>
#include <ModelAPI_Data.h>
#include <ModelAPI_Feature.h>
#include <ModelAPI_Folder.h>
friend class Model_ValidatorsFactory;
friend class Model_SelectionNaming;
friend class Model_ResultConstruction;
+ friend class Model_ResultBody;
+ friend class Model_Tools;
public:
/// The simplest constructor. "setLabel" must be called just after to initialize correctly.
Model_Data();
/// Returns the name of the feature visible by the user in the object browser
- MODEL_EXPORT virtual std::string name();
+ MODEL_EXPORT virtual std::wstring name();
/// Defines the name of the feature visible by the user in the object browser
- MODEL_EXPORT virtual void setName(const std::string& theName);
+ MODEL_EXPORT virtual void setName(const std::wstring& theName);
+ /// Return \c true if the object has been renamed by the user
+ MODEL_EXPORT virtual bool hasUserDefinedName() const;
+ /// Returns version of the feature (empty string if not applicable)
+ MODEL_EXPORT virtual std::string version();
+ /// Initialize the version of the feature
+ MODEL_EXPORT virtual void setVersion(const std::string& theVersion);
/// Returns the attribute that references to another document
MODEL_EXPORT virtual std::shared_ptr<ModelAPI_AttributeDocRef> document(const std::string& theID);
/// Returns the attribute that contains real value with double precision
/// Returns the attribute that contains string values array
MODEL_EXPORT virtual std::shared_ptr<ModelAPI_AttributeTables>
tables(const std::string& theID);
+ /// Returns the attribute that contains image
+ MODEL_EXPORT virtual std::shared_ptr<ModelAPI_AttributeImage>
+ image(const std::string& theID);
/// Returns the generic attribute by identifier
/// \param theID identifier of the attribute
MODEL_EXPORT virtual const std::string& id(const std::shared_ptr<ModelAPI_Attribute>& theAttr);
/// Returns true if data belongs to same features
MODEL_EXPORT virtual bool isEqual(const std::shared_ptr<ModelAPI_Data>& theData);
- /// Returns true if it is correctly connected t othe data model
+ /// Returns true if it is correctly connected to the data model
MODEL_EXPORT virtual bool isValid();
/// Returns the label where the shape must be stored (used in ResultBody)
- TDF_Label& shapeLab()
+ TDF_Label shapeLab() const
{
- return myLab;
+ return myLab.IsNull() ? myLab : myLab.Father().FindChild(2);
}
/// Initializes object by the attributes: must be called just after the object is created
/// for each attribute of the object
/// \param theID identifier of the attribute that can be referenced by this ID later
/// \param theAttrType type of the created attribute (received from the type method)
+ /// \param theIndex index of the attribute in the internal data structure, for not-floating
+ /// attributes it is -1 to let it automatically be added
/// \returns the just created attribute
MODEL_EXPORT virtual AttributePtr
- addAttribute(const std::string& theID, const std::string theAttrType);
+ addAttribute(const std::string& theID, const std::string theAttrType, const int theIndex = -1);
+
+ /// Adds a floating attribute (that may be added/removed during the data life)
+ /// \param theID identifier of the attribute that can be referenced by this ID later
+ /// \param theAttrType type of the created attribute (received from the type method)
+ /// \param theGroup identifier of the group this attribute belongs to, may be an empty string
+ MODEL_EXPORT virtual AttributePtr
+ addFloatingAttribute(const std::string& theID, const std::string theAttrType,
+ const std::string& theGroup);
+
+ /// Returns all groups of this data (ordered).
+ MODEL_EXPORT virtual void allGroups(std::list<std::string>& theGroups);
+
+ /// Returns an ordered list of attributes that belong to the given group
+ MODEL_EXPORT virtual void attributesOfGroup(const std::string& theGroup,
+ std::list<std::shared_ptr<ModelAPI_Attribute> >& theAttrs);
+
+ /// Remove all attributes of the given group
+ MODEL_EXPORT virtual void removeAttributes(const std::string& theGroup);
/// Useful method for "set" methods of the attributes: sends an UPDATE event and
/// makes attribute initialized
MODEL_EXPORT virtual void referencesToObjects(
std::list<std::pair<std::string, std::list<ObjectPtr> > >& theRefs);
- /// Copies all atributes content into theTarget data
+ /// Copies all attributes content into theTarget data
MODEL_EXPORT virtual void copyTo(std::shared_ptr<ModelAPI_Data> theTarget);
- /// Returns the invalid data pointer (to avoid working with NULL shared ptrs in swig)
+ /// Returns the invalid data pointer (to avoid working with NULL shared pointers in swig)
MODEL_EXPORT virtual std::shared_ptr<ModelAPI_Data> invalidPtr();
/// Returns the invalid data pointer: static method
/// Defines the custom "is in history" behavior
MODEL_EXPORT virtual void setIsInHistory(const bool theFlag);
- /// Returns true if the object is deleted, but some data is still keept in memory
+ /// Returns true if the object is deleted, but some data is still kept in memory
MODEL_EXPORT virtual bool isDeleted();
- /// Sets true if the object is deleted, but some data is still keept in memory
+ /// Sets true if the object is deleted, but some data is still kept in memory
MODEL_EXPORT virtual void setIsDeleted(const bool theFlag);
+ /// Erases all attributes from myAttrs, but keeping them in the data structure
+ void clearAttributes();
+
private:
- /// Removes all information about back references
- void eraseBackReferences();
/// Removes a back reference (with identifier which attribute references to this object)
/// \param theFeature feature referenced to this
/// \param theAttrID identifier of the attribute that is references from theFeature to this
/// Adds a back reference (with identifier which attribute references to this object
/// \param theFeature feature referenced to this
/// \param theAttrID identifier of the attribute that is references from theFeature to this
- /// \param theApplyConcealment applies consealment flag changes
+ /// \param theApplyConcealment applies concealment flag changes
void addBackReference(FeaturePtr theFeature, std::string theAttrID,
const bool theApplyConcealment = true);
/// Adds a back reference to an object
/// Returns true if object must be displayed in the viewer: flag is stored in the
/// data model, so on undo/redo, open/save or recreation of object by history-playing it keeps
- /// the original state i nthe current transaction.
+ /// the original state in the current transaction.
MODEL_EXPORT virtual bool isDisplayed();
/// Sets the displayed/hidden state of the object. If it is changed, sends the "redisplay"
/// Returns \c true if theAttribute1 is going earlier than theAttribute2 in the data
MODEL_EXPORT virtual bool isPrecedingAttribute(const std::string& theAttribute1,
const std::string& theAttribute2) const;
+
};
/// Generic method to register back reference, used in referencing attributes.