This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PtUnrealizeWidget()

Unrealize a widget

Synopsis:

int PtUnrealizeWidget( PtWidget_t *widget );

Library:

ph

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.

Unrealizing and realizing a widget can take some time. If you want to hide a widget quickly, you can set its Pt_ARG_POS to a very negative value. You should also set Pt_BLOCKED in its Pt_ARG_FLAGS so the widget won't get focus.

Returns:

0

Successful completion.

-1

An error occurred.

Classification:

Photon

See also:

PtDestroyWidget(), PtRealizeWidget()

"Widget life cycle" in the Introduction to the Photon Programmer's Guide