Caution: This version of this document is no longer maintained. For the latest documentation, see


Expand a given subtree


int PtGenTreeExpand( PtWidget_t *tree,
                     PtGenTreeItem_t *item,
                     PhEvent_t *event );


This function expands the given subtree item. The tree argument must point to the tree that contains the item or can be NULL if the item doesn't belong to any tree.

If tree isn't NULL, the Tree Item State method of that widget is called. If it returns a nonzero value, the item isn't expanded; if it returns zero, the expansion proceeds. PtGenTreeExpand() returns the same value.

Note: If the Tree Item State method destroys the item, make sure that it doesn't return zero.


The value returned by the Tree Item State method.



Interrupt handler No
Signal handler No
Thread No

See also:

PtGenTree, PtGenTreeItem_t

PhEvent_t in the Photon Library Reference