Функция CombineRgn (wingdi.h)

Статья
03/04/2024

Функция CombineRgn объединяет две области и сохраняет результат в третьем регионе. Две области объединяются в соответствии с указанным режимом.

Синтаксис

int CombineRgn(
  [in] HRGN hrgnDst,
  [in] HRGN hrgnSrc1,
  [in] HRGN hrgnSrc2,
  [in] int  iMode
);

Параметры

[in] hrgnDst

Дескриптор новой области с измерениями, определенными путем объединения двух других регионов. (Этот регион должен существовать до вызова CombineRgn .)

[in] hrgnSrc1

Дескриптор первой из двух областей для объединения.

[in] hrgnSrc2

Дескриптор второй из двух областей для объединения.

[in] iMode

Режим, указывающий, как будут объединены две области. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
RGN_AND	Создает пересечение двух объединенных областей.
RGN_COPY	Создает копию региона, определяемого hrgnSrc1.
RGN_DIFF	Объединяет части hrgnSrc1 , которые не являются частью hrgnSrc2.
RGN_OR	Создает объединение двух объединенных областей.
RGN_XOR	Создает объединение двух объединенных областей, за исключением перекрывающихся областей.

Возвращаемое значение

Возвращаемое значение указывает тип результирующей области. Может быть одним из указанных далее.

Код возврата	Описание
NULLREGION	Область пуста.
SIMPLEREGION	Область представляет собой один прямоугольник.
COMPLEXREGION	Область представляет собой более одного прямоугольника.
ошибка	Регион не создается.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll