CreateMetaFileA-Funktion (wingdi.h)

2024-11-20

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

Hinweis Diese Funktion wird nur zur Kompatibilität mit Metadateien im Windows-Format bereitgestellt. Erweiterte Metadateien 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 Windows-Format-Metadatei. Wenn dieser Parameter NULL-ist, ist die Windows-Format-Metadatei speicherbasiert, und der Inhalt geht verloren, wenn er 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 Windows-Format-Metadatei.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-.

Bemerkungen

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 Windows-Format Metadateienaufgefü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 Windows-Format-Metadatei 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 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 Windows-Format-Metadatei zu erstellen, notieren Sie die Grafikausgabe im MM_ANISOTROPIC Zuordnungsmodus. Die Datei kann keine Funktionen enthalten, die den Viewportursprung und -umfang ändern, oder sie können geräteabhängige Funktionen wie die SelectClipRgn--Funktion enthalten. Nach der Erstellung kann die Windows-Metadatei skaliert und auf jedes Ausgabegerätformat gerendert werden, indem der Viewport-Ursprung und die Umfange des Bilds definiert werden, bevor es wiedergegeben wird.

Anmerkung

Der wingdi.h-Header definiert CreateMetaFile als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wingdi.h (enthalten Windows.h)
Library	Gdi32.lib
DLL-	Gdi32.dll