Funzione GetClipRgn (wingdi.h)
La funzione GetClipRgn recupera un handle che identifica l'area di ritaglio definita dall'applicazione corrente per il contesto di dispositivo specificato.
Sintassi
int GetClipRgn(
[in] HDC hdc,
[in] HRGN hrgn
);
Parametri
[in] hdc
Handle per il contesto del dispositivo.
[in] hrgn
Handle per un'area esistente prima della chiamata della funzione. Al termine della funzione, questo parametro è un handle per una copia dell'area di ritaglio corrente.
Valore restituito
Se la funzione ha esito positivo e non esiste un'area di ritaglio per il contesto di dispositivo specificato, il valore restituito è zero. Se la funzione ha esito positivo ed è presente un'area di ritaglio per il contesto di dispositivo specificato, il valore restituito è 1. Se si verifica un errore, il valore restituito è -1.
Commenti
Un'area di ritaglio definita dall'applicazione è un'area di ritaglio identificata dalla funzione SelectClipRgn . Non è un'area di ritaglio creata quando l'applicazione chiama la funzione BeginPaint .
Se la funzione ha esito positivo, il parametro hrgn è un handle per una copia dell'area di ritaglio corrente. Le modifiche successive apportate a questa copia non influiscono sull'area di ritaglio corrente.
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 |