The contents of a TDocStd_Application, a document is a container for a data framework composed of labels and attributes. As such, TDocStd_Document is the entry point into the data framework. To gain access to the data, you create a document as follows: Handle(TDocStd_Document) MyDF = new TDocStd_Document The document also allows you to manage: More...

#include <TDocStd_Document.hxx>

Inheritance diagram for TDocStd_Document:

[legend]

Public Member Functions
	TDocStd_Document (const TCollection_ExtendedString &astorageformat)
	Constructs a document object defined by the string astorageformat. If a document is created outside of an application using this constructor, it must be managed by a Handle. Otherwise memory problems could appear: call of TDocStd_Owner::GetDocument creates a Handle(TDocStd_Document), so, releasing it will produce a crash.

Standard_Boolean	IsSaved () const
	the document is saved in a file.

Standard_Boolean	IsChanged () const
	returns True if document differs from the state of last saving. this method have to be called only working in the transaction mode

void	SetSaved ()
	This method have to be called to show document that it has been saved.

void	SetSavedTime (const Standard_Integer theTime)
	Say to document what it is not saved. Use value, returned earlier by GetSavedTime().

Standard_Integer	GetSavedTime () const
	Returns value of <mySavedTime> to be used later in SetSavedTime()

TCollection_ExtendedString	GetName () const
	raise if <me> is not saved.

TCollection_ExtendedString	GetPath () const
	returns the OS path of the file, in which one <me> is saved. Raise an exception if <me> is not saved.

void	SetData (const Handle< TDF_Data > &data)

Handle< TDF_Data >	GetData () const

TDF_Label	Main () const
	Returns the main label in this data framework. By definition, this is the label with the entry 0:1.

Standard_Boolean	IsEmpty () const
	Returns True if the main label has no attributes.

Standard_Boolean	IsValid () const
	Returns False if the document has been modified but not recomputed.

void	SetModified (const TDF_Label &L)
	Notify the label as modified, the Document becomes UnValid. returns True if <L> has been notified as modified.

void	PurgeModified ()
	Remove all modifications. After this call The document becomesagain Valid.

const TDF_LabelMap &	GetModified () const
	Returns the labels which have been modified in this document.

void	NewCommand ()
	Launches a new command. This command may be undone.

Standard_Boolean	HasOpenCommand () const
	returns True if a Command transaction is open in the curret .

void	OpenCommand ()
	Opens a new command transaction in this document. You can use HasOpenCommand to see whether a command is already open. Exceptions Standard_DomainError if a command is already open in this document.

Standard_Boolean	CommitCommand ()
	Commits documents transactions and fills the transaction manager with documents that have been changed during the transaction. If no command transaction is open, nothing is done. Returns True if a new delta has been added to myUndos.

void	AbortCommand ()
	Abort the Command transaction. Does nothing If there is no Command transaction open.

Standard_Integer	GetUndoLimit () const
	The current limit on the number of undos.

void	SetUndoLimit (const Standard_Integer L)
	Set the limit on the number of Undo Delta stored 0 will disable Undo on the document A negative value means no limit. Note that by default Undo is disabled. Enabling it will take effect with the next call to NewCommand. Of course this limit is the same for Redo.

void	ClearUndos ()
	Remove all stored Undos and Redos.

void	ClearRedos ()
	Remove all stored Redos.

Standard_Integer	GetAvailableUndos () const
	Returns the number of undos stored in this document. If this figure is greater than 0, the method Undo can be used.

Standard_Boolean	Undo ()
	Will UNDO one step, returns False if no undo was done (Undos == 0). Otherwise, true is returned and one step in the list of undoes is undone.

Standard_Integer	GetAvailableRedos () const
	Returns the number of redos stored in this document. If this figure is greater than 0, the method Redo can be used.

Standard_Boolean	Redo ()
	Will REDO one step, returns False if no redo was done (Redos == 0). Otherwise, true is returned, and one step in the list of redoes is done again.

const TDF_DeltaList &	GetUndos () const

const TDF_DeltaList &	GetRedos () const

void	RemoveFirstUndo ()
	Removes the first undo in the list of document undos. It is used in the application when the undo limit is exceed.

Standard_Boolean	InitDeltaCompaction ()
	Initializes the procedure of delta compaction Returns false if there is no delta to compact Marks the last delta as a "from" delta.

Standard_Boolean	PerformDeltaCompaction ()
	Performs the procedure of delta compaction Makes all deltas starting from "from" delta till the last one to be one delta.

void	UpdateReferences (const TCollection_AsciiString &aDocEntry)
	Set modifications on labels impacted by external references to the entry. The document becomes invalid and must be recomputed.

void	Recompute ()
	Recompute if the document was not valid and propagate the reccorded modification.

virtual void	Update (const Handle< CDM_Document > &aToDocument, const Standard_Integer aReferenceIdentifier, const Standard_Address aModifContext) override
	This method Update will be called to signal the end of the modified references list. The document should be recomputed and UpdateFromDocuments should be called. Update should returns True in case of success, false otherwise. In case of Failure, additional information can be given in ErrorString.

virtual TCollection_ExtendedString	StorageFormat () const override
	The Storage Format is the key which is used to determine in the application resources the storage driver plugin, the file extension and other data used to store the document.

void	SetEmptyLabelsSavingMode (const Standard_Boolean isAllowed)
	Sets saving mode for empty labels. If Standard_True, empty labels will be saved.

Standard_Boolean	EmptyLabelsSavingMode () const
	Returns saving mode for empty labels.

virtual void	ChangeStorageFormat (const TCollection_ExtendedString &newStorageFormat)
	methods for the nested transaction mode

void	SetNestedTransactionMode (const Standard_Boolean isAllowed=Standard_True)
	Sets nested transaction mode if isAllowed == Standard_True.

Standard_Boolean	IsNestedTransactionMode () const
	Returns Standard_True if mode is set.

void	SetModificationMode (const Standard_Boolean theTransactionOnly)
	if theTransactionOnly is True changes is denied outside transactions

Standard_Boolean	ModificationMode () const
	returns True if changes allowed only inside transactions

virtual void	BeforeClose ()
	Prepares document for closing.

TDocStd_FormatVersion	StorageFormatVersion () const
	Returns version of the format to be used to store the document.

void	ChangeStorageFormatVersion (const TDocStd_FormatVersion theVersion)
	Sets version of the format to be used to store the document.

void	DumpJson (Standard_OStream &theOStream, Standard_Integer theDepth=-1) const
	Dumps the content of me into the stream.

Public Member Functions inherited from CDM_Document
virtual Standard_Boolean	Update (TCollection_ExtendedString &ErrorString)
	This method Update will be called to signal the end of the modified references list. The document should be recomputed and UpdateFromDocuments should be called. Update should returns True in case of success, false otherwise. In case of Failure, additional information can be given in ErrorString.

virtual void	Extensions (TColStd_SequenceOfExtendedString &Extensions) const
	by default empties the extensions.

virtual Standard_Boolean	GetAlternativeDocument (const TCollection_ExtendedString &aFormat, Handle< CDM_Document > &anAlternativeDocument)
	This method can be redefined to extract another document in a different format. For example, to extract a Shape from an applicative document.

Standard_Integer	CreateReference (const Handle< CDM_Document > &anOtherDocument)
	Creates a reference from this document to {anOtherDocument}. Returns a reference identifier. This reference identifier is unique in the document and will not be used for the next references, even after the storing of the document. If there is already a reference between the two documents, the reference is not created, but its reference identifier is returned.

void	RemoveReference (const Standard_Integer aReferenceIdentifier)
	Removes the reference between the From Document and the To Document identified by a reference identifier.

void	RemoveAllReferences ()
	Removes all references having this document for From Document.

Handle< CDM_Document >	Document (const Standard_Integer aReferenceIdentifier) const
	Returns the To Document of the reference identified by aReferenceIdentifier. If the ToDocument is stored and has not yet been retrieved, this method will retrieve it.

Standard_Boolean	IsInSession (const Standard_Integer aReferenceIdentifier) const
	returns True if the To Document of the reference identified by aReferenceIdentifier is in session, False if it corresponds to a not yet retrieved document.

Standard_Boolean	IsStored (const Standard_Integer aReferenceIdentifier) const
	returns True if the To Document of the reference identified by aReferenceIdentifier has already been stored, False otherwise.

TCollection_ExtendedString	Name (const Standard_Integer aReferenceIdentifier) const
	returns the name of the metadata of the To Document of the reference identified by aReferenceIdentifier.

void	UpdateFromDocuments (const Standard_Address aModifContext) const
	call virtual method Update on all referencing documents. This method keeps the list of the – documents to process.It may be the starting of an update – cycle. If not, the reentrant calls made by Update method (without argument) will append the referencing documents to the list and call the Update method (with arguments). Only the first call to UpdateFromDocuments generate call to Update().

Standard_Integer	ToReferencesNumber () const
	returns the number of references having this document as From Document.

Standard_Integer	FromReferencesNumber () const
	returns the number of references having this document as To Document.

Standard_Boolean	ShallowReferences (const Handle< CDM_Document > &aDocument) const
	returns True is this document references aDocument;

Standard_Boolean	DeepReferences (const Handle< CDM_Document > &aDocument) const
	returns True is this document references aDocument;

Standard_Integer	CopyReference (const Handle< CDM_Document > &aFromDocument, const Standard_Integer aReferenceIdentifier)
	Copies a reference to this document. This method avoid retrieval of referenced document. The arguments are the original document and a valid reference identifier Returns the local identifier.

Standard_Boolean	IsReadOnly () const
	indicates that this document cannot be modified.

Standard_Boolean	IsReadOnly (const Standard_Integer aReferenceIdentifier) const
	indicates that the referenced document cannot be modified,

void	SetIsReadOnly ()

void	UnsetIsReadOnly ()

void	Modify ()
	Indicates that this document has been modified. This method increments the modification counter.

Standard_Integer	Modifications () const
	returns the current modification counter.

void	UnModify ()

Standard_Boolean	IsUpToDate (const Standard_Integer aReferenceIdentifier) const
	returns true if the modification counter found in the given reference is equal to the actual modification counter of the To Document. This method is able to deal with a reference to a not retrieved document.

void	SetIsUpToDate (const Standard_Integer aReferenceIdentifier)
	Resets the modification counter in the given reference to the actual modification counter of its To Document. This method should be called after the application has updated this document.

void	SetComment (const TCollection_ExtendedString &aComment)
	associates a comment with this document.

void	AddComment (const TCollection_ExtendedString &aComment)
	appends a comment into comments of this document.

void	SetComments (const TColStd_SequenceOfExtendedString &aComments)
	associates a comments with this document.

void	Comments (TColStd_SequenceOfExtendedString &aComments) const
	returns the associated comments through <aComments>. Returns empty sequence if no comments are associated.

Standard_ExtString	Comment () const
	Returns the first of associated comments. By default the comment is an empty string.

Standard_Boolean	IsStored () const

Standard_Integer	StorageVersion () const
	returns the value of the modification counter at the time of storage. By default returns 0.

void	SetMetaData (const Handle< CDM_MetaData > &aMetaData)
	associates database information to a document which has been stored. The name of the document is now the name which has beenused to store the data.

void	UnsetIsStored ()

Handle< CDM_MetaData >	MetaData () const

TCollection_ExtendedString	Folder () const

void	SetRequestedFolder (const TCollection_ExtendedString &aFolder)
	defines the folder in which the object should be stored.

TCollection_ExtendedString	RequestedFolder () const

Standard_Boolean	HasRequestedFolder () const

void	SetRequestedName (const TCollection_ExtendedString &aName)
	defines the name under which the object should be stored.

TCollection_ExtendedString	RequestedName ()
	Determines under which the document is going to be store. By default the name of the document will be used. If the document has no name its presentation will be used.

void	SetRequestedPreviousVersion (const TCollection_ExtendedString &aPreviousVersion)

void	UnsetRequestedPreviousVersion ()

Standard_Boolean	HasRequestedPreviousVersion () const

TCollection_ExtendedString	RequestedPreviousVersion () const

void	SetRequestedComment (const TCollection_ExtendedString &aComment)
	defines the Comment with which the object should be stored.

TCollection_ExtendedString	RequestedComment () const

void	LoadResources ()
	read (or rereads) the following resource.

Standard_Boolean	FindFileExtension ()

TCollection_ExtendedString	FileExtension ()
	gets the Desktop.Domain.Application.`FileFormat`.FileExtension resource.

Standard_Boolean	FindDescription ()

TCollection_ExtendedString	Description ()
	gets the `FileFormat`.Description resource.

Standard_Boolean	IsModified () const
	returns true if the version is greater than the storage version

Standard_OStream &	Print (Standard_OStream &anOStream) const

Standard_OStream &	operator<< (Standard_OStream &anOStream)

Standard_Boolean	IsOpened () const

void	Open (const Handle< CDM_Application > &anApplication)

CDM_CanCloseStatus	CanClose () const

void	Close ()

const Handle< CDM_Application > &	Application () const

virtual Standard_Boolean	CanCloseReference (const Handle< CDM_Document > &aDocument, const Standard_Integer aReferenceIdentifier) const
	A referenced document may indicate through this virtual method that it does not allow the closing of aDocument which it references through the reference aReferenceIdentifier. By default returns Standard_True.

virtual void	CloseReference (const Handle< CDM_Document > &aDocument, const Standard_Integer aReferenceIdentifier)
	A referenced document may update its internal data structure when {aDocument} which it references through the reference {aReferenceIdentifier} is being closed. By default this method does nothing.

Standard_Boolean	IsOpened (const Standard_Integer aReferenceIdentifier) const
	returns true if the document corresponding to the given reference has been retrieved and opened. Otherwise returns false. This method does not retrieve the referenced document

void	CreateReference (const Handle< CDM_MetaData > &aMetaData, const Standard_Integer aReferenceIdentifier, const Handle< CDM_Application > &anApplication, const Standard_Integer aToDocumentVersion, const Standard_Boolean UseStorageConfiguration)

Standard_Integer	CreateReference (const Handle< CDM_MetaData > &aMetaData, const Handle< CDM_Application > &anApplication, const Standard_Integer aDocumentVersion, const Standard_Boolean UseStorageConfiguration)

Standard_Integer	ReferenceCounter () const

virtual void	Update ()
	the following method should be used instead:

Handle< CDM_Reference >	Reference (const Standard_Integer aReferenceIdentifier) const

void	SetModifications (const Standard_Integer Modifications)

void	SetReferenceCounter (const Standard_Integer aReferenceCounter)

void	DumpJson (Standard_OStream &theOStream, Standard_Integer theDepth=-1) const
	Dumps the content of me into the stream.

Public Member Functions inherited from Standard_Transient
	Standard_Transient ()
	Empty constructor.

	Standard_Transient (const Standard_Transient &)
	Copy constructor – does nothing.

Standard_Transient &	operator= (const Standard_Transient &)
	Assignment operator, needed to avoid copying reference counter.

virtual	~Standard_Transient ()
	Destructor must be virtual.

virtual const opencascade::handle< Standard_Type > &	DynamicType () const
	Returns a type descriptor about this object.

Standard_Boolean	IsInstance (const opencascade::handle< Standard_Type > &theType) const
	Returns a true value if this is an instance of Type.

Standard_Boolean	IsInstance (const Standard_CString theTypeName) const
	Returns a true value if this is an instance of TypeName.

Standard_Boolean	IsKind (const opencascade::handle< Standard_Type > &theType) const
	Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism.

Standard_Boolean	IsKind (const Standard_CString theTypeName) const
	Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism.

Standard_Transient *	This () const
	Returns non-const pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero.

Standard_Integer	GetRefCount () const noexcept
	Get the reference counter of this object.

void	IncrementRefCounter () noexcept
	Increments the reference counter of this object.

Standard_Integer	DecrementRefCounter () noexcept
	Decrements the reference counter of this object; returns the decremented value.

virtual void	Delete () const
	Memory deallocator for transient classes.

Static Public Member Functions
static Handle< TDocStd_Document >	Get (const TDF_Label &L)
	Will Abort any execution, clear fields returns the document which contains <L>. raises an exception if the document is not found.

static TDocStd_FormatVersion	CurrentStorageFormatVersion ()
	Returns current storage format version of the document.

Static Public Member Functions inherited from Standard_Transient
static constexpr const char *	get_type_name ()
	Returns a type descriptor about this object.

static const opencascade::handle< Standard_Type > &	get_type_descriptor ()
	Returns type descriptor of Standard_Transient class.

Protected Member Functions
virtual Standard_Boolean	CommitTransaction ()
	Returns Standard_True done.

virtual void	AbortTransaction ()

virtual void	OpenTransaction ()
	methods for protection of changes outside transactions

Protected Member Functions inherited from CDM_Document
	CDM_Document ()

	~CDM_Document ()

Protected Attributes
TCollection_ExtendedString	myStorageFormat

TDF_DeltaList	myUndos

TDF_DeltaList	myRedos

Protected Attributes inherited from CDM_Document
Standard_Boolean	myResourcesAreLoaded

Additional Inherited Members
Public Types inherited from Standard_Transient
typedef void	base_type
	Returns a type descriptor about this object.

Detailed Description

The contents of a TDocStd_Application, a document is a container for a data framework composed of labels and attributes. As such, TDocStd_Document is the entry point into the data framework. To gain access to the data, you create a document as follows: Handle(TDocStd_Document) MyDF = new TDocStd_Document The document also allows you to manage:

modifications, providing Undo and Redo functions.
command transactions. Warning: The only data saved is the framework (TDF_Data)

Constructor & Destructor Documentation

◆ TDocStd_Document()

TDocStd_Document::TDocStd_Document ( const TCollection_ExtendedString & astorageformat )

Constructs a document object defined by the string astorageformat. If a document is created outside of an application using this constructor, it must be managed by a Handle. Otherwise memory problems could appear: call of TDocStd_Owner::GetDocument creates a Handle(TDocStd_Document), so, releasing it will produce a crash.

Member Function Documentation

◆ AbortCommand()

void TDocStd_Document::AbortCommand ( )

Abort the Command transaction. Does nothing If there is no Command transaction open.

◆ AbortTransaction()

virtual void TDocStd_Document::AbortTransaction ( )

protectedvirtual

◆ BeforeClose()

virtual void TDocStd_Document::BeforeClose ( )

virtual

Prepares document for closing.

◆ ChangeStorageFormat()

virtual void TDocStd_Document::ChangeStorageFormat ( const TCollection_ExtendedString & newStorageFormat )

virtual

methods for the nested transaction mode

◆ ChangeStorageFormatVersion()

void TDocStd_Document::ChangeStorageFormatVersion ( const TDocStd_FormatVersion theVersion )

Sets version of the format to be used to store the document.

◆ ClearRedos()

void TDocStd_Document::ClearRedos ( )

Remove all stored Redos.

◆ ClearUndos()

void TDocStd_Document::ClearUndos ( )

Remove all stored Undos and Redos.

◆ CommitCommand()

Standard_Boolean TDocStd_Document::CommitCommand ( )

Commits documents transactions and fills the transaction manager with documents that have been changed during the transaction. If no command transaction is open, nothing is done. Returns True if a new delta has been added to myUndos.

◆ CommitTransaction()

virtual Standard_Boolean TDocStd_Document::CommitTransaction ( )

protectedvirtual

Returns Standard_True done.

◆ CurrentStorageFormatVersion()

static TDocStd_FormatVersion TDocStd_Document::CurrentStorageFormatVersion ( )

static

Returns current storage format version of the document.

◆ DumpJson()

void TDocStd_Document::DumpJson	(	Standard_OStream &	theOStream,
		Standard_Integer	theDepth = `-1`
	)		const

Dumps the content of me into the stream.

◆ EmptyLabelsSavingMode()

Standard_Boolean TDocStd_Document::EmptyLabelsSavingMode ( ) const

Returns saving mode for empty labels.

◆ Get()

static Handle< TDocStd_Document > TDocStd_Document::Get ( const TDF_Label & L )

static

Will Abort any execution, clear fields returns the document which contains <L>. raises an exception if the document is not found.

◆ GetAvailableRedos()

Standard_Integer TDocStd_Document::GetAvailableRedos ( ) const

Returns the number of redos stored in this document. If this figure is greater than 0, the method Redo can be used.

◆ GetAvailableUndos()

Standard_Integer TDocStd_Document::GetAvailableUndos ( ) const

Returns the number of undos stored in this document. If this figure is greater than 0, the method Undo can be used.

◆ GetData()

Handle< TDF_Data > TDocStd_Document::GetData ( ) const

◆ GetModified()

const TDF_LabelMap & TDocStd_Document::GetModified ( ) const

Returns the labels which have been modified in this document.

◆ GetName()

TCollection_ExtendedString TDocStd_Document::GetName ( ) const

raise if <me> is not saved.

◆ GetPath()

TCollection_ExtendedString TDocStd_Document::GetPath ( ) const

returns the OS path of the file, in which one <me> is saved. Raise an exception if <me> is not saved.

◆ GetRedos()

const TDF_DeltaList & TDocStd_Document::GetRedos ( ) const

◆ GetSavedTime()

Standard_Integer TDocStd_Document::GetSavedTime ( ) const

Returns value of <mySavedTime> to be used later in SetSavedTime()

◆ GetUndoLimit()

Standard_Integer TDocStd_Document::GetUndoLimit ( ) const

The current limit on the number of undos.

◆ GetUndos()

const TDF_DeltaList & TDocStd_Document::GetUndos ( ) const

◆ HasOpenCommand()

Standard_Boolean TDocStd_Document::HasOpenCommand ( ) const

returns True if a Command transaction is open in the curret .

◆ InitDeltaCompaction()

Standard_Boolean TDocStd_Document::InitDeltaCompaction ( )

Initializes the procedure of delta compaction Returns false if there is no delta to compact Marks the last delta as a "from" delta.

◆ IsChanged()

Standard_Boolean TDocStd_Document::IsChanged ( ) const

returns True if document differs from the state of last saving. this method have to be called only working in the transaction mode

◆ IsEmpty()

Standard_Boolean TDocStd_Document::IsEmpty ( ) const

Returns True if the main label has no attributes.

◆ IsNestedTransactionMode()

Standard_Boolean TDocStd_Document::IsNestedTransactionMode ( ) const

Returns Standard_True if mode is set.

◆ IsSaved()

Standard_Boolean TDocStd_Document::IsSaved ( ) const

the document is saved in a file.

◆ IsValid()

Standard_Boolean TDocStd_Document::IsValid ( ) const

Returns False if the document has been modified but not recomputed.

◆ Main()

TDF_Label TDocStd_Document::Main ( ) const

Returns the main label in this data framework. By definition, this is the label with the entry 0:1.

◆ ModificationMode()

Standard_Boolean TDocStd_Document::ModificationMode ( ) const

returns True if changes allowed only inside transactions

◆ NewCommand()

void TDocStd_Document::NewCommand ( )

Launches a new command. This command may be undone.

◆ OpenCommand()

void TDocStd_Document::OpenCommand ( )

Opens a new command transaction in this document. You can use HasOpenCommand to see whether a command is already open. Exceptions Standard_DomainError if a command is already open in this document.

◆ OpenTransaction()

virtual void TDocStd_Document::OpenTransaction ( )

protectedvirtual

methods for protection of changes outside transactions

◆ PerformDeltaCompaction()

Standard_Boolean TDocStd_Document::PerformDeltaCompaction ( )

Performs the procedure of delta compaction Makes all deltas starting from "from" delta till the last one to be one delta.

◆ PurgeModified()

void TDocStd_Document::PurgeModified ( )

Remove all modifications. After this call The document becomesagain Valid.

◆ Recompute()

void TDocStd_Document::Recompute ( )

Recompute if the document was not valid and propagate the reccorded modification.

◆ Redo()

Standard_Boolean TDocStd_Document::Redo ( )

Will REDO one step, returns False if no redo was done (Redos == 0). Otherwise, true is returned, and one step in the list of redoes is done again.

◆ RemoveFirstUndo()

void TDocStd_Document::RemoveFirstUndo ( )

Removes the first undo in the list of document undos. It is used in the application when the undo limit is exceed.

◆ SetData()

void TDocStd_Document::SetData ( const Handle< TDF_Data > & data )

◆ SetEmptyLabelsSavingMode()

void TDocStd_Document::SetEmptyLabelsSavingMode ( const Standard_Boolean isAllowed )

Sets saving mode for empty labels. If Standard_True, empty labels will be saved.

◆ SetModificationMode()

void TDocStd_Document::SetModificationMode ( const Standard_Boolean theTransactionOnly )

if theTransactionOnly is True changes is denied outside transactions

◆ SetModified()

void TDocStd_Document::SetModified ( const TDF_Label & L )

Notify the label as modified, the Document becomes UnValid. returns True if <L> has been notified as modified.

◆ SetNestedTransactionMode()

void TDocStd_Document::SetNestedTransactionMode ( const Standard_Boolean isAllowed = Standard_True )

Sets nested transaction mode if isAllowed == Standard_True.

◆ SetSaved()

void TDocStd_Document::SetSaved ( )

This method have to be called to show document that it has been saved.

◆ SetSavedTime()

void TDocStd_Document::SetSavedTime ( const Standard_Integer theTime )

Say to document what it is not saved. Use value, returned earlier by GetSavedTime().

◆ SetUndoLimit()

void TDocStd_Document::SetUndoLimit ( const Standard_Integer L )

Set the limit on the number of Undo Delta stored 0 will disable Undo on the document A negative value means no limit. Note that by default Undo is disabled. Enabling it will take effect with the next call to NewCommand. Of course this limit is the same for Redo.

◆ StorageFormat()

virtual TCollection_ExtendedString TDocStd_Document::StorageFormat ( ) const

overridevirtual

The Storage Format is the key which is used to determine in the application resources the storage driver plugin, the file extension and other data used to store the document.

Implements CDM_Document.

◆ StorageFormatVersion()

TDocStd_FormatVersion TDocStd_Document::StorageFormatVersion ( ) const

Returns version of the format to be used to store the document.

◆ Undo()

Standard_Boolean TDocStd_Document::Undo ( )

Will UNDO one step, returns False if no undo was done (Undos == 0). Otherwise, true is returned and one step in the list of undoes is undone.

◆ Update()

virtual void TDocStd_Document::Update	(	const Handle< CDM_Document > &	aToDocument,
		const Standard_Integer	aReferenceIdentifier,
		const Standard_Address	aModifContext
	)

overridevirtual

This method Update will be called to signal the end of the modified references list. The document should be recomputed and UpdateFromDocuments should be called. Update should returns True in case of success, false otherwise. In case of Failure, additional information can be given in ErrorString.

Update the document by propagation

Update the document from internal stored modifications. If you want to undoing this operation, please call NewCommand before.

to change format (advanced programming)

Reimplemented from CDM_Document.

◆ UpdateReferences()

void TDocStd_Document::UpdateReferences ( const TCollection_AsciiString & aDocEntry )

Set modifications on labels impacted by external references to the entry. The document becomes invalid and must be recomputed.

Field Documentation

◆ myRedos

TDF_DeltaList TDocStd_Document::myRedos

protected

◆ myStorageFormat

TCollection_ExtendedString TDocStd_Document::myStorageFormat

protected

◆ myUndos

TDF_DeltaList TDocStd_Document::myUndos

protected

The documentation for this class was generated from the following file:

TDocStd_Document.hxx

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ TDocStd_Document()

Member Function Documentation

◆ AbortCommand()

◆ AbortTransaction()

◆ BeforeClose()

◆ ChangeStorageFormat()

◆ ChangeStorageFormatVersion()

◆ ClearRedos()

◆ ClearUndos()

◆ CommitCommand()

◆ CommitTransaction()

◆ CurrentStorageFormatVersion()

◆ DumpJson()

◆ EmptyLabelsSavingMode()

◆ Get()

◆ GetAvailableRedos()

◆ GetAvailableUndos()

◆ GetData()

◆ GetModified()

◆ GetName()

◆ GetPath()

◆ GetRedos()

◆ GetSavedTime()

◆ GetUndoLimit()

◆ GetUndos()

◆ HasOpenCommand()

◆ InitDeltaCompaction()

◆ IsChanged()

◆ IsEmpty()

◆ IsNestedTransactionMode()

◆ IsSaved()

◆ IsValid()

◆ Main()

◆ ModificationMode()

◆ NewCommand()

◆ OpenCommand()

◆ OpenTransaction()

◆ PerformDeltaCompaction()

◆ PurgeModified()

◆ Recompute()

◆ Redo()

◆ RemoveFirstUndo()

◆ SetData()

◆ SetEmptyLabelsSavingMode()

◆ SetModificationMode()

◆ SetModified()

◆ SetNestedTransactionMode()

◆ SetSaved()

◆ SetSavedTime()

◆ SetUndoLimit()

◆ StorageFormat()

◆ StorageFormatVersion()

◆ Undo()

◆ Update()

Update the document by propagation

to change format (advanced programming)

◆ UpdateReferences()

Field Documentation

◆ myRedos

◆ myStorageFormat

◆ myUndos