CombineRgn
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
Essa função combina duas regiões e armazena o resultado em uma região terceira.
As duas regiões são combinadas de acordo com o modo especificado.
Syntax
int CombineRgn(
HRGN hrgnDest,
HRGN hrgnSrc1,
HRGN hrgnSrc2,
int fnCombineMode
);
Parameters
- hrgnDest
[no] Identificador para uma nova região com dimensões definidas pelo combinar duas outras regiões. (Essa região deve existir antes CombineRgn é chamado.)
- hrgnSrc1
[no] Identificador para a primeira das duas regiões para ser combinados.
- hrgnSrc2
[no] Identificador para o segundo dos dois regiões para ser combinados.
fnCombineMode
[no] Especifica um modo indicando como as regiões dois serão combinadas.Este parâmetro pode ser uma dos seguinte valores.
Valor Descrição RGN_AND
Cria a interseção das duas regiões combinadas.
RGN_COPY
Cria um copiar da região identificada por hrgnSrc1.
RGN_DIFF
Combina as partes de hrgnSrc1 que não são parte hrgnSrc2.
RGN_OR
Cria a união de duas regiões combinados.
RGN_XOR
Cria a união de duas regiões combinados exceto Para qualquer áreas sobrepostas.
Return Value
O valor de retorno especifica o tipo da região resultante. NULLREGION indica que a região está vazio.
SIMPLEREGION indica que a região é um único retângulo.
COMPLEXREGION indica que a região é mais de um único retângulo.
ERRO indica que nenhuma região é criado.
Remarks
As três regiões não precisam estar distintas.
De exemplo, o hrgnSrc1 parâmetro pode igual a hrgnDest parâmetro.
Requirements
| Header | windows.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |