This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

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:

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

See also:

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