CreateMetaFileA-Funktion (wingdi.h)
Die CreateMetaFile-Funktion erstellt einen Gerätekontext für eine Metadatei im Windows-Format.
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 |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für