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

PtSetParentWidget()

Set the current parent widget

Synopsis:

PtWidget_t *PtSetParentWidget( PtWidget_t *widget );

Library:

ph

Description:

This function sets the current parent widget. Some widget classes (for example, windows, lists and menus) call this function when they're created.

---

Widgets that belong to the PtContainer class become the current parent widget when created. If you're creating multiple PtContainer-class widgets, you must ensure that each one is placed in the correct container. To do this, either call PtSetParentWidget() or specify the appropriate widget in the parent argument to PtCreateWidget(). If the widget argument to PtSetParentWidget() is NULL and you then call PtCreateWidget() with a Pt_DEFAULT_PARENT parent argument, the new widget has no parent. It's easier to create a widget with no parent by calling PtCreateWidget() with a parent argument of Pt_NO_PARENT.

---

Returns:

A pointer to the previous parent widget, or NULL if there is none.

Examples:

See PtCreateWidget().

Classification:

Photon

See also:

PtCreateWidget(), PtFindGuardian(), PtGetParent(), PtGetParentWidget(), PtReparentWidget(), PtValidParent(), PtWidgetParent()

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