Funzione GetRandomRgn (wingdi.h)

Articolo
08/27/2023

La funzione GetRandomRgn copia l'area di ritaglio di sistema di un contesto di dispositivo specificato in un'area specifica.

Sintassi

int GetRandomRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] INT  i
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] hrgn

Handle in un'area. Prima che la funzione venga chiamata, identifica un'area esistente. Al termine della funzione, identifica una copia dell'area di sistema corrente. L'area precedente identificata da hrgn viene sovrascritta.

[in] i

Questo parametro deve essere SYSRGN.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è 1. Se la funzione ha esito negativo, il valore restituito è -1. Se l'area da recuperare è NULL, il valore restituito è 0. Se la funzione ha esito negativo o l'area da recuperare è NULL, hrgn non viene inizializzato.

Commenti

Quando si usa il flag SYSRGN, si noti che l'area di ritaglio del sistema potrebbe non essere corrente a causa degli spostamenti delle finestre. Tuttavia, è possibile recuperare e usare l'area di ritaglio del sistema all'interno del blocco BeginPaint EndPaint- durante l'elaborazione WM_PAINT. In questo caso, l'area di sistema è l'intersezione dell'area di aggiornamento e l'area visibile corrente della finestra. Qualsiasi spostamento della finestra dopo il ritorno di GetRandomRgn e prima di EndPaint genererà un nuovo messaggio di WM_PAINT . Qualsiasi altro uso del flag SYSRGN può causare errori di disegno nell'applicazione.

L'area restituita è in coordinate dello schermo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll