PtGenTreeAddFirst()

Add items in front of any existing items

Synopsis:

int PtGenTreeAddFirst( PtWidget_t *tree, 
                       PtGenTreeItem_t *item,
                       PtGenTreeItem_t *parent );

Description:

This function adds the list of PtGenTreeItem_t structures pointed to by item to the given PtGenTree widget. The list of items are linked with their brother fields. The item argument can be NULL.

The parent argument identifies the parent item for the added items (if any). The new items are added in front of any existing children of the parent item. If parent is NULL, the items are added at the root level of the tree, before any existing items there.

The tree argument can be NULL, provided that parent points to an item that isn't attached to any tree widget.

PtGenTreeAddFirst() sets the Pt_TREE_ITEM_EXPANDABLE flag in the parent item, whether or not the item argument is NULL.

Returns:

0
Success.
-1
The item is already in a widget.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtGenTree, PtGenTreeItem_t