Поделиться через


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

Функция 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
Область представляет собой более одного прямоугольника.
ошибка
Регион не создается.

Комментарии

Эти три региона не должны быть разными. Например, параметр hrgnSrc1 может быть равен параметру hrgnDest .

Требования

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

См. также раздел

CreateEllipticRgn

CreateEllipticRgnIndirect

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

Функции регионов

Обзор регионов