Fonction SetMetaRgn (wingdi.h)

La fonction SetMetaRgn croise la région de découpage actuelle du contexte d’appareil spécifié avec la métarégion actuelle et enregistre la région combinée en tant que nouvelle métarégion pour le contexte d’appareil spécifié. La région de découpage est réinitialisée à une région null.

Syntaxe

int SetMetaRgn(
  [in] HDC hdc
);

Paramètres

[in] hdc

Handle dans le contexte de l’appareil.

Valeur retournée

La valeur de retour spécifie la complexité de la nouvelle région de découpage et peut être l’une des valeurs suivantes.

Code de retour	Description
NULLREGION	La région est vide.
SIMPLEREGION	La région est un rectangle unique.
COMPLEXREGION	La région est plusieurs rectangles.
ERROR	Une erreur est survenue. (La zone de découpage précédente n’est pas affectée.)

Remarques

La zone de découpage actuelle d’un contexte d’appareil est définie par l’intersection de sa zone de découpage et de sa métarégion.

La fonction SetMetaRgn ne doit être appelée qu’après l’enregistrement du contexte d’appareil d’origine d’une application en appelant la fonction SaveDC .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll

Voir aussi

Fonctions de découpage

Vue d’ensemble de la coupe

GetMetaRgn

SaveDC