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

PtGenTreeGoto()

Set the current item and position so that a given item is visible

Synopsis:

int PtGenTreeGoto( PtWidget_t *tree, 
                   PtGenTreeItem_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 item is NULL, there's no current item.

You can call PtGenTreeGoto() with an item whose ancestor is collapsed, in which case the ancestor is expanded.

Returns:

The value returned by the Tree Item State method.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtGenTree, PtGenTreeItem_t