validate_rectangle

bool validate_rectangle(handle window,
                        const irectangle* validate=null)

This function validates a rectangle by removing it from the window's update region.

Parameters

handle window

The handle of the window whose update region is being modified.

const irectangle* validate

A pointer to a rectangle that is to be validated. This rectangle is expressed in client coordinates. If null is specified or defaulted, the entire client area is validated.

Return

bool

true	The rectangle was successfuly validated.
false	The call failed.

Notes

The function begin_paint automatically validates the entire client area.

The system continues to generate paint messages until the current update region is validated.