-// Copyright (C) 2014-20xx CEA/DEN, EDF R&D
-
-// File: ModelAPI_Data.hxx
-// Created: 21 Mar 2014
-// Author: Mikhail PONIKAROV
+// Copyright (C) 2014-2019 CEA/DEN, EDF R&D
+//
+// This library is free software; you can redistribute it and/or
+// modify it under the terms of the GNU Lesser General Public
+// License as published by the Free Software Foundation; either
+// version 2.1 of the License, or (at your option) any later version.
+//
+// This library is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// Lesser General Public License for more details.
+//
+// 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
+//
+// See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
+//
#ifndef ModelAPI_Data_H_
#define ModelAPI_Data_H_
/// Returns the name of the feature visible by the user in the object browser
virtual std::string name() = 0;
-
/// Defines the name of the feature visible by the user in the object browser
virtual void setName(const std::string& theName) = 0;
+ /// Return \c true if the object has been renamed by the user
+ virtual bool hasUserDefinedName() const = 0;
/// Returns the attribute that references to another document
virtual std::shared_ptr<ModelAPI_AttributeDocRef> document(const std::string& theID) = 0;
/// 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
+ virtual std::shared_ptr<ModelAPI_Attribute> addAttribute(
+ const std::string& theID, const std::string theAttrType, const int theIndex = -1) = 0;
+
+ /// 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
virtual std::shared_ptr<ModelAPI_Attribute>
- addAttribute(const std::string& theID, const std::string theAttrType) = 0;
+ addFloatingAttribute(const std::string& theID, const std::string theAttrType,
+ const std::string& theGroup) = 0;
+
+ /// Returns all groups of this data (ordered).
+ virtual void allGroups(std::list<std::string>& theGroups) = 0;
+
+ /// Returns an ordered list of attributes that belong to the given group
+ virtual void attributesOfGroup(const std::string& theGroup,
+ std::list<std::shared_ptr<ModelAPI_Attribute> >& theAttrs) = 0;
+
+ /// Remove all attributes of the given group
+ virtual void removeAttributes(const std::string& theGroup) = 0;
/// Useful method for "set" methods of the attributes: sends an UPDATE event and
/// makes attribute initialized
/// Blocks sending "attribute updated" if theBlock is true
/// \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)
- /// \returns the just created attribute
- virtual void blockSendAttributeUpdated(
+ /// \returns the previous state of block
+ virtual bool blockSendAttributeUpdated(
const bool theBlock, const bool theSendMessage = true) = 0;
/// Erases all the data from the data model
/// Copies all attributes content into theTarget data
virtual void copyTo(std::shared_ptr<ModelAPI_Data> theTarget) = 0;
- /// 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)
virtual std::shared_ptr<ModelAPI_Data> invalidPtr() = 0;
/// Identifier of the transaction when object (feature or result) was updated last time.
/// This method is called by the updater.
virtual void setUpdateID(const int theID) = 0;
- /// Returns the owner of htis data
+ /// Returns the owner of this data
virtual std::shared_ptr<ModelAPI_Object> owner() = 0;
- /// 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
virtual bool isDeleted() = 0;
- /// 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
virtual void setIsDeleted(const bool theFlag) = 0;
+ /// Returns \c true if theAttribute1 is going earlier than theAttribute2 in the data
+ virtual bool isPrecedingAttribute(const std::string& theAttribute1,
+ const std::string& theAttribute2) const = 0;
+
protected:
/// Objects are created for features automatically
ModelAPI_Data();
/// 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.
virtual bool isDisplayed() = 0;
/// Sets the displayed/hidden state of the object. If it is changed, sends the "redisplay"