The connection is defined through the Structures TableIndex properties and the structure TableIndex property. These properties define the column from which the associated values are taken. If a Table Tree object is added to the Views collection of a Table object, a node is inserted for each row in the table. All necessary information is taken from the table to initialize the new nodes.

Special treatment is reserved for the first Structure item’s TableIndex. This property is used as a row index in the Table object to define the parent of a node. Consequently, the content of the Table object has to define a completely consistent subtree and may not add any nodes elsewhere.

In addition, the application must define the node that indicates where to insert the new subtree through the Table Tree object’s TableInsertRoot property. If this property equals nothing, the subtree is inserted into the root. Otherwise this property must point to an already existing node. In this case, this node is used as parent for the subtree.

Unlike the connection between a Table View control and a Table object, the connection to the Table Tree is only temporary. After the new nodes are inserted, the Table Tree control cancels the connection.