PtTreeRemoveList()

Unlink the root item

Synopsis:

void PtTreeRemoveList( PtWidget_t *tree, 
                       PtTreeItem_t *first );

Description:

This function unlinks the item first and its brothers (together with their children) from their parent (and previous brother) and sets their parent fields to NULL:

The results of using PtTreeRemoveList().

The tree argument must point to the PtTree widget that contains the items, or be NULL if the items don't belong to any tree.

Note that if tree==NULL and first has no parent but has a previous brother, then the function won't be able to find the previous brother and won't be able unlink first from its previous brother.

Classification:

Photon

See also:

PtTree, PtTreeAddAfter(), PtTreeAddFirst(), PtTreeAllocItem(), PtTreeFreeAllItems(), PtTreeFreeItems(), PtTreeItem_t, PtTreeModifyItem(), PtTreeRemoveChildren(), PtTreeRemoveItem()