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

PtTreeGoto()

Set the current item

Synopsis:

int PtTreeGoto( PtWidget_t *list, 
                PtTreeItem_t *item );

Description:

This function sets the current item and (if necessary) the current position so that the new current item is visible (see "Current item" in the description of PtGenList).

If you pass item as NULL, there will be no current item.

Returns:

0

Success.

Nonzero

item belongs to a collapsed subtree, and a callback function prevented the subtree from being expanded.

Classification:

Photon

See also:

PtTree, PtTreeClearSelection(), PtTreeGetCurrent(), PtTreeGoto(), PtTreeItem_t, PtTreeRootItem(), PtTreeSelect(), PtTreeSelectedItems(), PtTreeSetSelIndexes(), PtTreeShow(), PtTreeUnselect(), PtTreeUnselectNonBrothers()