Função CombineRgn (wingdi.h)

Artigo
03/04/2024

A função CombineRgn combina duas regiões e armazena o resultado em uma terceira região. As duas regiões são combinadas de acordo com o modo especificado.

Sintaxe

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

Parâmetros

[in] hrgnDst

Um identificador para uma nova região com dimensões definidas pela combinação de duas outras regiões. (Essa região deve existir antes que CombineRgn seja chamado.)

[in] hrgnSrc1

Um identificador para a primeira das duas regiões a serem combinadas.

[in] hrgnSrc2

Um identificador para a segunda de duas regiões a serem combinadas.

[in] iMode

Um modo que indica como as duas regiões serão combinadas. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
RGN_AND	Cria a interseção das duas regiões combinadas.
RGN_COPY	Cria uma cópia da região identificada por hrgnSrc1.
RGN_DIFF	Combina as partes de hrgnSrc1 que não fazem parte do hrgnSrc2.
RGN_OR	Cria a união de duas regiões combinadas.
RGN_XOR	Cria a união de duas regiões combinadas, exceto para quaisquer áreas sobrepostas.

Retornar valor

O valor retornado especifica o tipo da região resultante. Pode ser um dos seguintes valores.

Código de retorno	Descrição
NULLREGION	A região está vazia.
SIMPLEREGION	A região é um único retângulo.
COMPLEXREGION	A região é mais do que um único retângulo.
ERROR	Nenhuma região é criada.

Comentários

As três regiões não precisam ser distintas. Por exemplo, o parâmetro hrgnSrc1 pode ser igual ao parâmetro hrgnDest .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll