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
);

Parâmetros

[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.

Retornar valor

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.

Comentários

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.

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

Funções de recorte

Visão geral do recorte

Selectcliprgn