Função GetRandomRgn (wingdi.h)

Artigo
03/08/2023

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