PtDamageExtent()

Mark an area of a widget as damaged so that it will be redrawn

Synopsis:

int PtDamageExtent( PtWidget_t *widget, 
                    PhRect_t const *extent );

Description:

This function marks the specified widget as damaged and adds extent to the clipping list that will be used the next time the widget engine redraws this widget.

All widgets in front of the damaged widget that intersect with extent will be redrawn. If the damaged widget's fill color is transparent, all widgets behind it that intersect extent will be redrawn. In all cases, the clipping will be set to extent.

The widget library takes care of updating widgets whenever resources are modified. So you don't normally use this function unless you're mixing Pg calls with widget calls, and want a widget to redraw and repair itself directly.

Returns:

0

Success.

-1

An error occurred. This function fails if the widget isn't a container and doesn't reside in a container, or if there isn't enough memory to expand the damage list.

Examples:

See PhBlit().

Classification:

Photon

See also:

PtDamageWidget()