Middleware, development tools, realtime operating system
software and services for superior embedded design


Home
QNX Community Resources
QNX Documentation Library
PtWidgetParent

PtWidgetParent

QNX Software Systems
Developer Resources
Blogs
Board support packages
Foundry27 projects
Forums
Hardware support listing
Online video tutorials
Product documentation
Technical Articles

PtWidgetParent()

Get a widget's parent

Synopsis:

PtWidget_t *PtWidgetParent( PtWidget_t *widget );

Library:

ph

Description:

This macro returns a pointer to the parent of the specified widget. If no parent exists, the macro 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 PtValidParent().

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 Managing Widgets in Application Code chapter of the Photon Programmer's Guide