PtTreeAddFirst()

Add a root item to a tree list

Synopsis:

void PtTreeAddFirst( PtWidget_t *tree, 
                     PtTreeItem_t *item,
                     PtTreeItem_t *parent );

Description:

This function adds a list of trees linked with the brother member of the PtTreeItem_t structure.

The parent argument identifies the parent item for the added items. The new items will be added in front of any existing children of the parent item:

The results of using PtTreeAddFirst().

The parent argument may also be NULL, in which case the item will be added at the root level of the tree before any existing items at the root level.

This function may be called with a NULL tree argument, as long as parent points to an item that isn't attached to any tree widget.

The PtTreeAddFirst() function automatically sets the Pt_TREE_ITEM_EXPANDABLE flag in the parent item.

Classification:

Photon

See also:

PtTree, PtTreeAddAfter(), PtTreeAllocItem(), PtTreeFreeAllItems(), PtTreeFreeItems(), PtTreeItem_t, PtTreeRootItem(),