Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/widget_ref/pt/pttreeremovelist.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/widget_ref/pt/pttreeremovelist.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/widget_ref/pt/pttreeremovelist.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/widget_ref/pt/pttreeremovelist.html on line 8

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 gen.father fields to NULL:


Example of PtTreeRemoveList()


The results of using PtTreeRemoveList().

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

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

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

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


Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/widget_ref/pt/pttreeremovelist.html on line 106

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/widget_ref/pt/pttreeremovelist.html on line 106