Middleware, development tools, realtime operating system
software and services for superior embedded design


Home
QNX Community Resources
QNX Documentation Library
PtUnrealizeWidget

PtUnrealizeWidget

QNX Software Systems
Developer Resources
Blogs
Board support packages
Foundry27 projects
Forums
Hardware support listing
Online video tutorials
Product documentation
Technical Articles

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.


Note: 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

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtDestroyWidget(), PtRealizeWidget()

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