ItemPath Data Type

Description

The hierarchical path from the root of the tree to a specific item. You have to always specify the entire hierarchy. Each part in the hierarchy of the item path can either be a name, an index, or a combination of both. You can uniquely identify each item in the hierarchical path by specifying one or more of its attributes.

Items in a tree have the following attributes:

The hierarchical relationship between the item and other items.
The title or the caption of the item.
The 0-based ordinal number of the item in relation to its siblings.

Example

The following examples show how you can identify unique items within a tree by path, index, or a combination of both path and index:

Specification	Item
"/Desktop/Applications/Games"	A unique item "Games" under a unique item "Applications" under a unique item "Desktop" at the outer level of the tree.
"/Desktop/[2]/[4]"	The fifth item under the third item under a unique item "Desktop" at the outer level of the tree.
"/Desktop/Applications[2]/Games"	A unique item "Games" under the third item with the text "Applications" under a unique item "Desktop" at the outer level of the tree.