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

Is this a root node.

A root node has itself as a parent (it is not a child of any node). Newly constructed nodes (before they are inserted into an ImageFile tree) start out as root nodes. It is possible to temporarily create small trees that are unattached to any ImageFile. In these temporary trees, the top-most node will be a root node. After the tree is attached to the ImageFile tree, the only root node will be the pre-created one of the ImageTree (the one returned by ImageFile::root). The concept of attachement is slightly larger than that of the parent-child relationship (see Node::isAttached and CompressedVectorNode::CompressedVectorNode for more details).

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