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

PtEnableSurfaceByAction()

Enable all control surfaces associated with an action

Synopsis:

void PtEnableSurfaceByAction( 
         PtWidget_t *widget,
         PtWidgetClassRef_t const *cref,
         ushort_t action_id,
         ulong_t flags );

Library:

ph

Description:

This function enables all surfaces associated with an action, restoring them from a disabled state.

The widget argument specifies the widget owning the surfaces, while cref and action_id specify the class and manifest of the action associated with surfaces to be enabled.

The flags argument specifies additional action to take, and may include the following values:

Pt_DAMAGE_SURFACE
Damage the surface if its state changes. This is useful if a surface draws differently depending on its enabled/disabled state.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtDisableSurface(), PtDisableSurfaceByAction(), PtDisableSurfaceById(), PtEnableSurface(), PtEnableSurfaceById(), PtSurfaceIsDisabled(), PtSurfaceIsEnabled()

Control Surfaces chapter of the Photon Programmer's Guide