Méthode Metafile ::Metafile(IStream,HDC,constRect&,MetafileFrameUnit,EmfType,constWCHAR) (gdiplusheaders.h)

Article
01/10/2024

Crée un objet Metafile ::Metafile pour l’enregistrement dans une interface IStream .

Syntaxe

void Metafile(
  [in]      IStream           *stream,
  [in]      HDC               referenceHdc,
  [in, ref] const Rect &      frameRect,
  [in]      MetafileFrameUnit frameUnit,
  [in]      EmfType           type,
  [in]      const WCHAR       *description
);

Paramètres

[in] stream

Type : IStream*

Pointeur vers une interface COM IStream qui pointe vers un flux de données dans un fichier. Lorsque les commandes sont enregistrées, elles sont enregistrées dans ce flux.

[in] referenceHdc

Type : HDC

Windows gère dans un contexte d’appareil qui contient les attributs de l’appareil d’affichage utilisé pour enregistrer le métafichier.

[in, ref] frameRect

Type : const Rect

Référence à un rectangle qui limite l’affichage du métafichier.

[in] frameUnit

Type : MetafileFrameUnit

facultatif. Élément de l’énumération MetafileFrameUnit qui spécifie l’unité de mesure pour frameRect. La valeur par défaut est MetafileFrameUnitGdi.

[in] type

Type : EmfType

facultatif. Élément de l’énumération EmfType qui spécifie le type de métafichier qui sera enregistré. La valeur par défaut est EmfTypeEmfPlusDual.

[in] description

Type : const WCHAR*

facultatif. Pointeur vers une chaîne à caractères larges qui spécifie le nom descriptif du métafichier. La valeur par défaut est NULL.

Valeur de retour

None

Remarques

Lors de l’enregistrement dans un fichier, le fichier doit être accessible en écriture et Windows GDI+ doit être en mesure d’obtenir un verrou exclusif sur le fichier.

Configuration requise


Client minimal pris en charge	Windows XP, 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	gdiplusheaders.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll