Função SelectClipRgn (wingdi.h)

  • Artigo

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