Função ExtSelectClipRgn (wingdi.h)

A função ExtSelectClipRgn combina a região especificada com a região de recorte atual usando o modo especificado.

Sintaxe

int ExtSelectClipRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] int  mode
);

[in] hdc

Um identificador para o contexto do dispositivo.

[in] hrgn

Um identificador para a região a ser selecionada. Esse identificador não deve ser NULL , a menos que o modo de RGN_COPY seja especificado.

[in] mode

A operação a ser executada. Deve ser um dos valores a seguir.

Valor	Significado
RGN_AND	A nova região de recorte combina as áreas sobrepostas da região de recorte atual e a região identificada pelo hrgn.
RGN_COPY	A nova região de recorte é uma cópia da região identificada pelo hrgn. Isso é idêntico a SelectClipRgn. Se a região identificada pelo hrgn for NULL, a nova região de recorte será a região de recorte padrão (a região de recorte padrão é uma região nula).
RGN_DIFF	A nova região de recorte combina as áreas da região de recorte atual com as áreas excluídas da região identificada pelo hrgn.
RGN_OR	A nova região de recorte combina a região de recorte atual e a região identificada pelo hrgn.
RGN_XOR	A nova região de recorte combina a região de recorte atual e a região identificada pelo hrgn , mas exclui as áreas sobrepostas.

O valor retornado especifica a complexidade da nova região de recorte; pode ser um dos valores a seguir.

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 de um retângulo.
ERROR	Ocorreu um erro.

Se ocorrer um erro quando essa função for chamada, a região de recorte anterior para o contexto do dispositivo especificado não será afetada.

A função ExtSelectClipRgn pressupõe que as coordenadas da região especificada sejam especificadas em unidades de dispositivo.

Apenas uma cópia da região identificada pelo parâmetro hrgn é usada. A própria região pode ser reutilizado após essa chamada ou pode ser excluída.

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