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

PtDamageSurface(), PtDamageSurfaceById()

Mark a control surface as damaged so that it will be redrawn

Synopsis:

void PtDamageSurface( PtWidget_t *widget,
                      PtSurface_t *surface );

void PtDamageSurfaceById( PtWidget_t *widget,
                          uchar_t surface_id );

Library:

ph

Description:

These functions flag a control surface to be redrawn. The widget argument specifies the widget owning the surface. The functions differ in how they identify the control surface:

PtDamageSurface()
Uses the surface argument, which points to a PtSurface_t structure that describes the control surface. This pointer must not be NULL.
PtDamageSurfaceById()
Searches the control surfaces belonging to the widget for the one with an ID of surface_id.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtDamageSurfaceByAction()

Control Surfaces chapter of the Photon Programmer's Guide