2022.2

Note: The "MetaPage" on page171 object does not have a child accessor method as it does not con-
tain any Node objects.
For the available properties and methods see the Node type's documentation: "MetaJob" on page165,
"MetaGroup" on page166, "MetaDocument" on page168, "MetaDatapage" on page169, and
"MetaPage" on page171.
Including or excluding nodes from the output
The Selected property of any Node object is used to select whether the node - and all of its children,
down to the smallest unit - are to be included in the final output or not.
If a node has its Selected property set to true, all of its children that also have their own Selected prop-
erty set to true will print.
If Selected is false, its children will not print, regardless of their Selected status.
Methods like Count, Index or PageCount work on all nodes, regardless of their Selected attributes.
Methods whose names start with "Selected" however are meant to work with selected nodes. In other
words, "Selected..." methods only consider nodes that are set to be part of the output.
SelectedCount only considers child nodes that have their Selected property set to true, but also checks
if their parents also have their Selected property to true. It is therefore possible that a node is selected
but is not counted.
The SelectedState property can be used to verify the effective selection state of a node, i.e. whether or
not a node will be part of the output and, if not, whether it is because it is itself not selected or one of its
parents is not.
Attributes and Fields
In addition to being a collections of objects, a Metadata Node also contains two types of elements,
called "Attributes" on page184 and "Fields" on page185. These are name/value pairs, where the name
is case-insensitive.
l
An Attribute is a read-only, system-defined element which holds certain information about a cer-
tain node in the Metadata structure. This information can be static (e.g. the size of a physical
page) or evaluated on-the-fly (e.g. the number of documents in a group). Attributes are non-repet-
itive (i.e. name is unique) and do not persist through Metadata recreation.
For an overview of Attributes and in which Node objects they are available, see the "Metadata
Attributes reference" on page73.
l
A Field is a read-write, user-defined element which holds custom information about a certain
node in the Metadata structure. Fields are repetitive (i.e. the same field may appear multiple
times) and persist through Metadata recreation.
They are each stored in a collection container object (a MetaAttributeCollection and a MetaFieldCol-
lection, respectively).
As is the case with Nodes, both collections share a number of methods and properties. The Fields
Page 173