|This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.|
Unrealize a widget
int PtUnrealizeWidget( PtWidget_t *widget );
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.|
- Successful completion.
- An error occurred.
“Widget life cycle” in the Introduction to the Photon Programmer's Guide