EnumEnhMetaFile-Funktion (wingdi.h)

Artikel
08/27/2023

Die EnumEnhMetaFile-Funktion listet die Datensätze in einer Metadatei im erweiterten Format auf, indem sie jeden Datensatz abruft und an die angegebene Rückruffunktion übergibt. Die von der Anwendung bereitgestellte Rückruffunktion verarbeitet jeden Datensatz nach Bedarf. Die Enumeration wird fortgesetzt, bis der letzte Datensatz verarbeitet wurde oder wenn die Rückruffunktion null zurückgibt.

Syntax

BOOL EnumEnhMetaFile(
  [in] HDC           hdc,
  [in] HENHMETAFILE  hmf,
  [in] ENHMFENUMPROC proc,
  [in] LPVOID        param,
  [in] const RECT    *lpRect
);

Parameter

[in] hdc

Ein Handle für einen Gerätekontext. Dieses Handle wird an die Rückruffunktion übergeben.

[in] hmf

Ein Handle für eine erweiterte Metadatei.

[in] proc

Ein Zeiger auf die von der Anwendung bereitgestellte Rückruffunktion. Weitere Informationen finden Sie in der EnhMetaFileProc-Funktion .

[in] param

Ein Zeiger auf optionale Rückruffunktionsdaten.

[in] lpRect

Ein Zeiger auf eine RECT-Struktur , der die Koordinaten der oberen linken und unteren rechten Ecke des Bilds in logischen Einheiten angibt.

Rückgabewert

Wenn die Rückruffunktion erfolgreich alle Datensätze in der erweiterten Metadatei aufzählt, ist der Rückgabewert ungleich null.

Wenn die Rückruffunktion nicht erfolgreich alle Datensätze in der erweiterten Metadatei aufzählt, ist der Rückgabewert null.

Hinweise

Punkte am Rand des Rechtecks, auf die der lpRect-Parameter zeigt, sind in der Abbildung enthalten. Wenn der hdc-ParameterNULL ist, ignoriert das System lpRect.

Wenn die Rückruffunktion die PlayEnhMetaFileRecord-Funktion aufruft , muss hdc einen gültigen Gerätekontext identifizieren. Das System verwendet den Transformations- und Zuordnungsmodus des Gerätekontexts, um das bild zu transformieren, das von der PlayEnhMetaFileRecord-Funktion angezeigt wird.

Sie können die EnumEnhMetaFile-Funktion verwenden, um eine enhanced-metafile in eine andere einzubetten.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll