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

PtTreeSelectedItems()

Fill a buffer with item pointers

Synopsis:

PtTreeItem_t **PtTreeSelectedItems( 
                      PtWidget_t *widget, 
                      PtTreeItem_t **buffer );

Description:

This function fills a buffer with pointers to the tree's selected items:

• If buffer is NULL, the function allocates a buffer using malloc(), and the buffer is NULL-terminated.
• If buffer is non-NULL, the function adds a NULL at the end only if there are no selected items in the widget.

Items that belong to collapsed subtrees aren't included in the buffer.

Returns:

A pointer to the buffer.

Classification:

Photon

See also:

PtTree, PtTreeClearSelection(), PtTreeGetCurrent(), PtTreeGetSelIndexes(), PtTreeGoto(), PtTreeItem_t, PtTreeSelect(), PtTreeSetSelIndexes(), PtTreeUnselect(), PtTreeUnselectNonBrothers()