Função GetClipRgn (wingdi.h)

A função GetClipRgn recupera um identificador que identifica a região de recorte definida pelo aplicativo atual para o contexto do dispositivo especificado.

Sintaxe

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

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] hrgn

Um identificador para uma região existente antes da função ser chamada. Depois que a função retorna, esse parâmetro é um identificador para uma cópia da região de recorte atual.

Retornar valor

Se a função for bem-sucedida e não houver nenhuma região de recorte para o contexto de dispositivo fornecido, o valor retornado será zero. Se a função for bem-sucedida e houver uma região de recorte para o contexto de dispositivo fornecido, o valor retornado será 1. Se ocorrer um erro, o valor retornado será -1.

Comentários

Uma região de recorte definida pelo aplicativo é uma região de recorte identificada pela função SelectClipRgn . Não é uma região de recorte criada quando o aplicativo chama a função BeginPaint .

Se a função for bem-sucedida, o parâmetro hrgn será um identificador para uma cópia da região de recorte atual. As alterações subsequentes nessa cópia não afetarão a região de recorte atual.

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

Beginpaint

Funções de recorte

Visão geral do recorte

Selectcliprgn