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

PtWidgetActiveSurface()

Get a widget's currently active control surface

Synopsis:

unsigned char PtWidgetActiveSurface( PtWidget_t *widget );

Library:

ph

Description:

This macro retrieves the provided widget's currently “active” surface. The active surface is the last surface that consumed an event of type Ph_EV_BUT_PRESS.

Returns:

The ID of the currently active control surface, or 0 if there isn't one.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtFindSurface(), PtFindSurfaceByAction()

Control Surfaces chapter of the Photon Programmer's Guide