Função SelectClipRgn (wingdi.h)

A função SelectClipRgn seleciona uma região como a região de recorte atual para o contexto do dispositivo especificado.

Sintaxe

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

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] hrgn

Um identificador para a região a ser selecionada.

Valor retornado

O valor retornado especifica a complexidade da região e 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. (A região de recorte anterior não foi afetada.)

Comentários

Apenas uma cópia da região selecionada é usada. A região em si pode ser selecionada para qualquer número de outros contextos de dispositivo ou pode ser excluída.

A função SelectClipRgn pressupõe que as coordenadas de uma região sejam especificadas em unidades de dispositivo.

Para remover a região de recorte de um contexto de dispositivo, especifique um identificador de região NULL .

Exemplos

Para obter um exemplo, consulte Saída de recorte.

Requisitos

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

ExtSelectClipRgn