PtRealizeWidget()

Initialize a widget and its children

Synopsis:

int PtRealizeWidget( PtWidget_t *widget );

Description:

This function initializes a widget and its children, making them visible to the user and possibly making them 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

See also:

PtCreateWidget(), PtDestroyWidget(), PtUnrealizeWidget()