Freigeben über


Graphics::EnumerateMetafile(constMetafile*,constRect&,constRect&,Unit,EnumerateMetafileProc,VOID*,constImageAttributes*)-Methode (gdiplusgraphics.h)

Die Graphics::EnumerateMetafile-Methode ruft eine anwendungsdefinierte Rückruffunktion für jeden Datensatz in einer angegebenen Metadatei auf. Sie können diese Methode verwenden, um eine Metadatei anzuzeigen, indem Sie PlayRecord in der Rückruffunktion aufrufen.

Syntax

Status EnumerateMetafile(
  [in]      const Metafile        *metafile,
  [in, ref] const Rect &          destRect,
  [in, ref] const Rect &          srcRect,
  [in]      Unit                  srcUnit,
  [in]      EnumerateMetafileProc callback,
  [in]      VOID                  *callbackData,
  [in]      const ImageAttributes *imageAttributes
);

Parameter

[in] metafile

Typ: const Metafile*

Zeiger auf eine Metadatei, die aufgezählt werden soll.

[in, ref] destRect

Typ: const Rect

Verweis auf ein Rect-Objekt , das das Rechteck angibt, in dem die Metadatei angezeigt wird.

[in, ref] srcRect

Typ: const Rect

Verweis auf ein Rect-Objekt , das den Angezeigten Teil der Metadatei angibt.

[in] srcUnit

Typ: Einheit

Element der Unit-Enumeration , das die Maßeinheit für das Quellrechteck angibt.

[in] callback

Typ: EnumerateMetafileProc

Zeiger auf eine anwendungsdefinierte Rückruffunktion. Der Prototyp für die Rückruffunktion ist in Gdiplustypes.h angegeben.

[in] callbackData

Typ: VOID*

Optional. Zeiger auf einen Datenblock, der an die Rückruffunktion übergeben wird. Der Standardwert ist NULL.

[in] imageAttributes

Typ: ImageAttributes*

Optional. Zeiger auf ein ImageAttributes-Objekt , das Farbanpassungen für die angezeigte Metadatei angibt. Der Standardwert ist NULL.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile gdiplusgraphics.h (include Gdiplus.h)
Bibliothek Gdiplus.lib
DLL Gdiplus.dll