Partager via


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