Compartilhar via


Função CombineRgn (wingdi.h)

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

Confira também

CreateEllipticRgn

CreateEllipticRgnIndirect

CreatePolyPolygonRgn

CreatePolygonRgn

Createrectrgn

CreateRectRgnIndirect

CreateRoundRectRgn

Funções de região

Visão geral das regiões