PtUnrealizeWidget()

Unrealize a widget

Synopsis:

int PtUnrealizeWidget( PtWidget_t *widget );

Description:

This function unrealizes the specified widget and all its children: the widgets are removed from the display, and the widget engine will no longer invoke their callbacks.

Unrealized widgets still exist in the widget hierarchy and can be realized again.

Returns:

0: Successful completion.
-1: An error occurred.

Examples:

See PtWidgetChildBack().

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

See also:

PtDestroyWidget(), PtRealizeWidget()