Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ PtTreeSelectedItems

Media Vault

Software Library

Restoration Projects

Artifacts Sought

PtTreeSelectedItems

[Previous] [Contents] [Index] [Next]

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.

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

Returns:

A pointer to the buffer.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

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


[Previous] [Contents] [Index] [Next]

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026