PtGenTreeRemoveItem()

Remove a given item and its children from its parents and siblings

Synopsis:

void PtGenTreeRemoveItem( PtWidget_t *tree,
                          PtGenTreeItem_t *item );

Description:

This function unlinks the given item (together with its children) from its parent and brothers (if any) and sets item->parent and item->brother to NULL. The tree argument must point to the PtGenTree widget containing item or be NULL if item doesn't belong to any tree.

If tree is NULL and item has no parent but has a previous sibling, then PtGenTreeRemoveItem() isn't able to find the previous sibling and unlinks item from its sibling. The function does nothing if item->parent and tree are NULL.

PtGenTreeRemoveItem() never clears the Pt_TREE_ITEM_EXPANDABLE flag in the item's parent.

Classification:

Photon