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

PtFSRemoveItem()

Unlink an item

Synopsis:

void PtFSRemoveItem( PtWidget_t *fs,   
                     PtFileSelItem_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.


Example of PtFSRemoveItem()


The results of using PtFSRemoveItem().

The fs argument must point to the PtFileSel widget containing the item, or be NULL if the item doesn't belong to any file selector.


Note: If fs is NULL and the item has no parent but has a previous brother, the function won't be able to find the previous brother and therefore can't unlink the item from its brother. The function does nothing if item->parent and fs are both NULL.

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


Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No