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) |
PtRealizeWidget()
Make a widget and its children visible and possibly interactive
Synopsis:
int PtRealizeWidget( PtWidget_t *widget );
Library:
ph
Description:
This function makes a widget and its children visible to the user and possibly interactive. To create a hierarchy of widgets, you typically make successive calls to PtCreateWidget(), and then call PtRealizeWidget(), passing it the root of the hierarchy.
 |
Some widgets (for example, menus) have Pt_DELAY_REALIZE set in their Pt_ARG_FLAGS. Such delay-realized widgets aren't visibly rendered when their ancestors are realized. Although they're present in the hierarchy, delay-realized widgets become visible only when the application realizes them specifically with a call to PtRealizeWidget(). An application might do this, for example, if the user requested it to activate a menu. |
Returns:
- 0
- Success.
- -1
- Out of memory, or an invalid widget class was specified.
Examples:
See PtContainerGiveFocus() and PtClearWidget().
Classification:
Photon
| Safety: | |
|---|---|
| Interrupt handler | No |
| Signal handler | No |
| Thread | No |
See also:
PtCreateWidget(), PtDestroyWidget(), PtUnrealizeWidget()
"Widget life cycle" in the Introduction to the Photon Programmer's Guide
|
|
|
|
All content ©2004-2008, QNX Software Systems