Middleware, development tools, realtime operating system
software and services for superior embedded design
- Developer Resources
- Blogs
- Board support packages
- Foundry27 projects
- Forums
- Hardware support listing
- Online video tutorials
- Product documentation
- Technical Articles
![[Previous]](../prev.gif) |
![[Contents]](../contents.gif) |
![[Index]](../keyword_index.gif) |
![[Next]](../next.gif) |
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
| Safety: | |
|---|---|
| Interrupt handler | No |
| Signal handler | No |
| Thread | No |
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
|
|
|
|
All content ©2004-2008, QNX Software Systems