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

PtTreeFreeItems()

Free an unlinked item

Synopsis:

int PtTreeFreeItems( PtTreeItem_t *item );

Description:

This function frees the given subtrees (the item together with its brothers and their children). The items must not belong to any tree -- use PtTreeRemoveChildren(), PtTreeRemoveItem(), or PtTreeRemoveList() to remove the subtree from a tree widget before freeing the subtrees.

Returns:

0

Success.

-1

The item is still in a widget.

Classification:

Photon

See also:

PtTree, PtTreeAllocItem(), PtTreeFreeAllItems(), PtTreeItem_t, PtTreeRemoveChildren(), PtTreeRemoveItem(), PtTreeRemoveList()