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

PtWidgetParent()

Get a widget's parent

Synopsis:

PtWidget_t *PtWidgetParent( PtWidget_t *widget );

Description:

This function returns a pointer to the parent of the specified widget. If no parent exists, the function returns NULL.


Note: Some container widgets, including PtDivider, PtMenuBar, PtMultiText, and PtScrollArea redirect children to an alternate parent. For all container widgets, it's best to call PtValidParent() to determine the "real" parent of the children.

Examples:

See PtWidgetChildBack().

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtCreateWidget(), PtFindGuardian(), PtGetParent(), PtGetParentWidget(), PtReParentWidget(), PtSetParentWidget(), PtValidParent(), PtWidgetBrotherBehind(), PtWidgetBrotherInFront(), PtWidgetChildBack(), PtWidgetChildFront()

"Ordering widgets" in the Creating Widgets in Application Code chapter of the Photon Programmer's Guide


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