Função GetRandomRgn (wingdi.h)
A função GetRandomRgn copia a região de recorte do sistema de um contexto de dispositivo especificado para uma região específica.
Sintaxe
int GetRandomRgn(
[in] HDC hdc,
[in] HRGN hrgn,
[in] INT i
);
Parâmetros
[in] hdc
Um identificador para o contexto do dispositivo.
[in] hrgn
Um identificador para uma região. Antes que a função seja chamada, isso identifica uma região existente. Depois que a função retorna, isso identifica uma cópia da região atual do sistema. A região antiga identificada pelo hrgn é substituída.
[in] i
Esse parâmetro deve ser SYSRGN.
Retornar valor
Se a função for bem-sucedida, o valor retornado será 1. Se a função falhar, o valor retornado será -1. Se a região a ser recuperada for NULL, o valor retornado será 0. Se a função falhar ou a região a ser recuperada for NULL, hrgn não será inicializado.
Comentários
Ao usar o sinalizador SYSRGN, observe que a região de recorte do sistema pode não ser atual devido aos movimentos da janela. No entanto, é seguro recuperar e usar a região de recorte do sistema dentro do bloco BeginPaint-EndPaint durante WM_PAINT processamento. Nesse caso, a região do sistema é a interseção da região de atualização e a área visível atual da janela. Qualquer movimento de janela após o retorno de GetRandomRgn e antes de EndPaint resultará em uma nova mensagem de WM_PAINT . Qualquer outro uso do sinalizador SYSRGN pode resultar em erros de pintura em seu aplicativo.
A região retornada está em coordenadas de tela.
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 |