Graphics ::EnumerateMetafile(constMetafile*,constPointF*,INT,constRectF&,Unit,EnumerateMetafileProc,VOID*,constImageAttributes*) method (gdiplusgraphics.h)

La méthode Graphics ::EnumerateMetafile appelle une fonction de rappel définie par l’application pour chaque enregistrement dans un métafichier spécifié. Vous pouvez utiliser cette méthode pour afficher un métafichier en appelant PlayRecord dans la fonction de rappel.

Syntaxe

Status EnumerateMetafile(
  [in]      const Metafile        *metafile,
  [in]      const PointF          *destPoints,
  [in]      INT                   count,
  [in, ref] const RectF &         srcRect,
  [in]      Unit                  srcUnit,
  [in]      EnumerateMetafileProc callback,
  [in]      VOID                  *callbackData,
  [in]      const ImageAttributes *imageAttributes
);

Paramètres

[in] metafile

Type : const Metafile*

Pointeur vers un métafichier à énumérer.

[in] destPoints

Type : const Point*

Pointeur vers un tableau de points de destination. Il s’agit d’un tableau de trois points qui définit le paralléliogramme de destination pour le métafichier affiché.

[in] count

Type : INT

Entier qui spécifie le nombre de points dans le tableau destPoints .

[in, ref] srcRect

Type : const RectF

Référence au rectangle qui spécifie la partie du métafichier affichée.

[in] srcUnit

Type : Unité

Élément de l’énumération Unit qui spécifie l’unité de mesure du rectangle source.

[in] callback

Type : EnumerateMetafileProc

Pointeur vers une fonction de rappel définie par l’application. Le prototype de la fonction de rappel est fourni dans Gdiplustypes.h.

[in] callbackData

Type : VOID*

facultatif. Pointeur vers un bloc de données passé à la fonction de rappel. La valeur par défaut est NULL.

[in] imageAttributes

Type : ImageAttributes*

facultatif. Pointeur vers un objet ImageAttributes qui spécifie des réglages de couleurs pour le métafichier affiché. La valeur par défaut est NULL.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Configuration requise

Condition requise	Valeur
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	gdiplusgraphics.h (include Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll