CombineRgn(3w)

CombineRgn3w

Usage

INT CombineRgn
(
HRGN hDest,
HRGN hSrc1,
HRGN hSrc2,
INT mode
)

Overview

Combines two regions with the specified operation and stores the result in the specified destination region.

Params

hDest [In] The region that receives the combined result.

hSrc1 [In] The first source region.

hSrc2 [In] The second source region.

mode [In] The way in which the source regions will be combined. See notes.

Returns

Success: NULLREGION - The new region is empty. SIMPLEREGION - The new region can be represented by one rectangle. COMPLEXREGION - The new region can only be represented by more than one rectangle.

Failure: ERROR.

Notes

The two source regions can be the same region. The mode can be one of the following:

RGN_AND - Intersection of the regions

RGN_OR - Union of the regions

RGN_XOR - Unions of the regions minus any intersection.

RGN_DIFF - Difference (subtraction) of the regions.

Implementation

Declared in "windowsx.h".

Implemented in "dlls/gdi32/region.c".

Debug channel "region".

Releases

5 releases since Debian 2.1 (Slink); the text changed 4 times.

  1. 2.1
  2. 4.0
  3. 5.0
  4. 6.0
  5. 7

From libwine-dev 1.4.1-4 in Debian 7 (Wheezy). Parsed by carta from the page's man source.