CreateMetaFileA-Funktion (wingdi.h)

Artikel
08/27/2023

Die CreateMetaFile-Funktion erstellt einen Gerätekontext für eine Metadatei im Windows-Format.

Hinweis Diese Funktion wird nur zur Kompatibilität mit Metadateien im Windows-Format bereitgestellt. Metadateien im erweiterten Format bieten überlegene Funktionen und werden für neue Anwendungen empfohlen. Die entsprechende Funktion für eine Metadatei im erweiterten Format ist CreateEnhMetaFile.

Syntax

HDC CreateMetaFileA(
  [in] LPCSTR pszFile
);

Parameter

[in] pszFile

Ein Zeiger auf den Dateinamen für die zu erstellende Metadatei im Windows-Format. Wenn dieser Parameter NULL ist, ist die Metadatei im Windows-Format speicherbasiert, und ihr Inhalt geht verloren, wenn sie mithilfe der DeleteMetaFile-Funktion gelöscht wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den Gerätekontext für die Metadatei im Windows-Format.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.

Hinweise

Wenn Textargumente Unicode-Zeichen verwenden müssen, verwenden Sie die CreateMetaFile-Funktion als Breitzeichenfunktion. Wenn Textargumente Zeichen aus dem Windows-Zeichensatz verwenden müssen, verwenden Sie diese Funktion als ANSI-Funktion.

CreateMetaFile ist eine Metadateifunktion im Windows-Format. Diese Funktion unterstützt nur 16-Bit-Windows-basierte Anwendungen, die in Metadateien im Windows-Format aufgeführt sind. GDI-Funktionen wie PolyBezier, die nicht Teil von 16-Bit-Windows waren, werden nicht erfasst oder wiedergegeben.

Der von dieser Funktion erstellte Gerätekontext kann verwendet werden, um GDI-Ausgabefunktionen in einer Metadatei im Windows-Format aufzuzeichnen. Sie kann nicht mit GDI-Abfragefunktionen wie GetTextColor verwendet werden. Wenn der Gerätekontext mit einer GDI-Ausgabefunktion verwendet wird, wird der Rückgabewert dieser Funktion zu TRUE , wenn die Funktion aufgezeichnet wird und andernfalls FALSE . Wenn ein Objekt mithilfe der SelectObject-Funktion ausgewählt wird, wird nur eine Kopie des Objekts aufgezeichnet. Das Objekt gehört weiterhin zur Anwendung.

Um eine skalierbare Metadatei im Windows-Format zu erstellen, notieren Sie die Grafikausgabe im MM_ANISOTROPIC Zuordnungsmodus. Die Datei kann weder Funktionen enthalten, die den Ursprung und die Erweiterungen des Viewports ändern, noch geräteabhängige Funktionen wie die SelectClipRgn-Funktion enthalten. Nach der Erstellung kann die Windows-Metadatei skaliert und in ein beliebiges Ausgabegeräteformat gerendert werden, indem der Viewportursprung und die Ausdehnungen des Bilds vor der Wiedergabe definiert werden.

Hinweis

Der wingdi.h-Header definiert CreateMetaFile als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
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 (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll