PtTreeAddAfter()

Insert an item after the specified item

Synopsis:

int PtTreeAddAfter( PtWidget_t *tree,
                    PtTreeItem_t *item,
                    PtTreeItem_t *brother );

Description:

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

PtTreeAddAfter() assumes that item points to a list of trees. The tree variable points to a PtTree widget. The new items are added to the specified tree below the specified brother:


Example of PtTreeAddAfter()


The results of using PtTreeAddAfter().

You can call this function with a NULL tree argument, as long as brother points to an item that isn't attached to any tree widget.

Returns:

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

Examples:

See Allocating items and building a tree in the description of PtTree.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtTree, PtTreeAddFirst(), PtTreeAllocItem(), PtTreeFreeAllItems(), PtTreeFreeItems(), PtTreeItem_t