E57 Foundation API v1.1.312  Aug. 10, 2011
bool isAttached ( ) const

Has node been attached into the tree of an ImageFile.

Nodes are attached into an ImageFile tree by inserting them as children (directly or indirectly) of the ImageFile's root node. Nodes can also be attached to an ImageFile if they are used in the codecs or prototype trees of an CompressedVectorNode that is attached. Attached nodes will be saved to disk when the ImageFile is closed, and restored when the ImageFile is read back in from disk. Unattached nodes will not be saved to disk. It is not recommended to create nodes that are not eventually attached to the ImageFile.

Precondition:
The destination ImageFile must be open (i.e. destImageFile().isOpen()).
Postcondition:
No visible object state is modified.
Returns:
true if node is child of (or in codecs or prototype of a child CompressedVectorNode of) the root node of an ImageFile.
Exceptions:
E57_ERROR_IMAGEFILE_NOT_OPEN
E57_ERROR_INTERNALAll objects in undocumented state
See also:
NodeFunctions.cpp example, Node::destImageFile, ImageFile::root
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Defines