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 |