Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pt/ptrealizewidget.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pt/ptrealizewidget.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pt/ptrealizewidget.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pt/ptrealizewidget.html on line 8

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.


Note: 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


Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pt/ptrealizewidget.html on line 131

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pt/ptrealizewidget.html on line 131