extended_select_clipping_region

int extended_select_clipping_region(handle device,
                                    handle region,
                                    int mode)

This function combines a region with the clipping region.

Parameters

handle device

The handle of the device context.

handle region

The handle of the region to be combined with the clipping region.

int mode

region_combine::and	The new clipping region is the intersection of the current clipping region with the specified region.
region_combine::or	The new clipping region is the union of the current clipping region with the specified region.
region_combine::exclusive_or	The new clipping region is the exclusive or of the current clipping region with the specified region.
region_combine::difference	The new clipping region is the difference of the current clipping region and the specified region.
region_combine::copy	The new clipping region is set to be a copy of the specified region.

Return

int

The new clipping region's complexity (see enumeration region_type).

Notes

device coordinates are assumed for the source region.

If an error occurs, the current clipping region remains unaffected.

The source region is unchanged by this function.