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

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

See also:

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