CMetaFileDC::CreateEnhanced

BOOL CreateEnhanced ( CDC * pDCRef, LPCTSTR lpszFileName, LPCRECT lpBounds, LPCTSTR lpszDescription );

Valeur de retour

Une poignée du contexte de périphérique pour le métafichier amélioré, en cas de succès ; sinon NULL.

Paramètres

pDCRef

Identifie un dispositif de référence pour le métafichier amélioré.

lpszFileName

Points d'une chaîne de caractères terminée par null. Spécifie le nom du fichier pour le métafichier amélioré être créé. Si ce paramètre est NULL, le métafichier amélioré est fondé de mémoire et son contenu perdu lorsque l'objet est détruit ou lorsque les :: DeleteEnhMetaFile fonction est appelée.

lpBounds

Pointe vers une structure de données RECT ou un objet CRect qui spécifie les dimensions en unités HIMETRIC (par incréments de.01-millimètre) de l'image seront stockées dans le métafichier amélioré.

lpszDescription

Vers une chaîne terminée par zéro qui spécifie le nom de l'application qui a créé l'image, ainsi que titre de l'image.

Remarques

Crée un contexte de périphérique d'un métafichier amélioré-format. Ce contrôleur de domaine peut être utilisé pour stocker une image indépendante du périphérique.

Windows utilise le dispositif de référence identifié par le paramètre pDCRef pour enregistrer la résolution et les unités de l'appareil sur lequel une image apparaît à l'origine. Si le paramètre pDCRef est NULL, il utilise le périphérique d'affichage actuel de référence.

Les membres de gauche et du haut de la structure de données RECT indiqué par le paramètre lpBounds doivent être plus petites que les membres de la droite et en bas, respectivement. Points sur les bords du rectangle sont inclus dans l'image. Si lpBounds est NULL, l'interface de périphérique graphique (GDI) calcule les dimensions du plus petit rectangle qui peuvent entourer l'image dessinée par l'application. Le paramètre lpBounds doit être fourni lorsque c'est possible.

La chaîne indiquée par le paramètre lpszDescription doit contenir un caractère nul entre le nom de l'application et le nom de l'image et doit se terminer avec deux caractères null — par exemple, « XYZ Graphics Editor\0Bald Eagle\0\0, « où \0 représente le caractère null. Si lpszDescription est NULL, il n'existe aucune entrée correspondante dans l'en-tête de métafichier amélioré.

Applications utilisent le contrôleur de domaine créé par cette fonction pour stocker une image graphique dans un métafichier amélioré. La poignée de l'identification de ce contrôleur de domaine peut être passée à une fonction GDI.

Après qu'une application stocke une image dans un métafichier amélioré, il peut afficher l'image sur n'importe quel dispositif de sortie en appelant la fonction CDC::PlayMetaFile . Lors de l'affichage de l'image, Windows utilise le rectangle indiqué par le paramètre lpBounds et les données de résolution de l'appareil de référence pour la position et l'échelle de l'image. Le contexte de périphérique retourné par cette fonction contient les mêmes attributs par défaut associées à la toute nouvelle DC.

Les applications doivent utiliser le :: GetWinMetaFileBits fonction pour convertir un métafichier amélioré à l'ancien format de métafichier Windows.

Le nom de fichier pour le métafichier amélioré devrait utiliser le.Extension de l'EMF.

Aperçu CMetaFileDC | ; Membres de la classe | Graphique de la hiérarchie

Index