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

PtDamageExposed()

Damage the specified widgets

Synopsis:

void PtDamageExposed( PtWidget_t *widget, 
                      PhTile_t *tile );

Arguments:

widget
A pointer to the widget to damage.
tile
A list of PhTile_t structures (see the Photon Library Reference) that define the rectangles to damage. These rectangles should be relative to the widget's origin.

Description:

This function damages the list of rectangles given in tile on the parent of widget. The damage may extend beyond the extent of the widget.


Note: This function frees the tile list automatically.

Examples:

To redraw a transparent widget due to a data change:

tile = PhGetTile();
PtWidgetExtent( widget, &tile->rect );
tile->next = NULL;
PtDamageExposed( widget, tile );

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PhGetTile(), PhTile_t in the Photon Library Reference