PtTreeRemoveItem()

Unlink an item

Synopsis:

void PtTreeRemoveItem( PtWidget_t *tree,
                       PtTreeItem_t *item );

Description:

This function unlinks the given item together with its children from its parent and brothers (if any) and sets the item->parent and item->brother fields to NULL:

The results of using PtTreeRemoveItem().

The tree argument must point to the PtTree widget containing the item, or be NULL if the item doesn't belong to any tree.

Note that if tree==NULL and the item has no parent but has a previous brother, then the function won't be able to find the previous brother and will unlink the item from its brother. The function will do nothing if item -> parent==NULL and tree==NULL.

The PtTreeRemove() function never clears the Pt_TREE_ITEM_EXPANDABLE flag in the item's parent.

Classification:

Photon

See also:

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