Funzione SetMetaRgn (wingdi.h)

La funzione SetMetaRgn interseca l'area di ritaglio corrente per il contesto del dispositivo specificato con la metaregion corrente e salva l'area combinata come nuova metaregion per il contesto del dispositivo specificato. L'area di ritaglio viene reimpostata in un'area Null.

Sintassi

int SetMetaRgn(
  [in] HDC hdc
);

Parametri

[in] hdc

Handle nel contesto del dispositivo.

Valore restituito

Il valore restituito specifica la complessità della nuova area di ritaglio e può essere uno dei valori seguenti.

Codice restituito	Descrizione
NULLREGION	L'area è vuota.
SIMPLEREGION	L'area è un singolo rettangolo.
COMPLEXREGION	L'area è più di un rettangolo.
ERROR	Si è verificato un errore. (L'area di ritaglio precedente non è influenzata).

Commenti

L'area di ritaglio corrente di un contesto del dispositivo è definita dall'intersezione della relativa area di ritaglio e dalla relativa metaregion.

La funzione SetMetaRgn deve essere chiamata solo dopo il salvataggio del contesto del dispositivo originale di un'applicazione chiamando la funzione SaveDC .

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

Vedi anche

Funzioni di ritaglio

Panoramica del ritaglio

GetMetaRgn

SaveDC