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

PtShowSurface(), PtShowSurfaceById()

Show a hidden control surface

Synopsis:

int PtShowSurface( PtWidget_t *widget,
                   PtSurface_t *surface );

int PtShowSurfaceById( PtWidget_t *widget,
                       uchar_t surface_id );

Library:

ph

Description:

These functions show a control surface, restoring it from a hidden state. The widget argument specifies the widget owning the surface. The functions differ in how they identify the control surface:

PtShowSurface()

Uses the surface argument, which points to a PtSurface_t structure that describes the control surface. This pointer must not be NULL.

PtShowSurfaceById()

Searches the control surfaces belonging to the widget for the one with an ID of surface_id.

Returns:

0

Success.

-1

The specified surface couldn't be found or wasn't hidden.

Classification:

Photon

See also:

PtHideSurface(), PtHideSurfaceByAction(), PtHideSurfaceById(), PtShowSurfaceByAction(), PtSurfaceIsHidden(), PtSurfaceIsShown()

Control Surfaces chapter of the Photon Programmer's Guide