PtWidgetActiveSurface()

Get a widget's currently active control surface

Synopsis:

uchar_t 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

See also:

PtFindSurface(), PtFindSurfaceByAction()

Control Surfaces chapter of the Photon Programmer's Guide