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