SetWinMetaFileBits-Funktion (wingdi.h)
Die SetWinMetaFileBits-Funktion konvertiert eine Metadatei aus dem älteren Windows-Format in das neue erweiterte Format und speichert die neue Metadatei im Arbeitsspeicher.
Syntax
HENHMETAFILE SetWinMetaFileBits(
[in] UINT nSize,
[in] const BYTE *lpMeta16Data,
[in] HDC hdcRef,
[in] const METAFILEPICT *lpMFP
);
Parameter
[in] nSize
Die Größe des Puffers in Bytes, der die Metadatei im Windows-Format enthält.
[in] lpMeta16Data
Ein Zeiger auf einen Puffer, der die Metadatendaten im Windows-Format enthält. (Es wird davon ausgegangen, dass die Daten mithilfe der GetMetaFileBitsEx - oder GetWinMetaFileBits-Funktion abgerufen wurden.)
[in] hdcRef
Ein Handle für einen Referenzgerätekontext.
[in] lpMFP
Ein Zeiger auf eine METAFILEPICT-Struktur , die die vorgeschlagene Größe des Metadateibilds und den Zuordnungsmodus enthält, der beim Erstellen des Bilds verwendet wurde.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für eine speicherbasierte erweiterte Metadatei.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.
Hinweise
Windows verwendet die Auflösungsdaten des Referenzgerätekontexts und die Daten in der METAFILEPICT-Struktur , um ein Bild zu skalieren. Wenn der hdcRef-ParameterNULL ist, verwendet das System Auflösungsdaten für das aktuelle Ausgabegerät. Wenn der lpmfp-ParameterNULL ist, verwendet das System den MM_ANISOTROPIC Zuordnungsmodus, um das Bild so zu skalieren, dass es der gesamten Geräteoberfläche entspricht. Das hMF-Element der METAFILEPICT-Struktur wird nicht verwendet.
Wenn die Anwendung das erweiterte Metadateihandle nicht mehr benötigt, sollte es durch Aufrufen der DeleteEnhMetaFile-Funktion gelöscht werden.
Das von dieser Funktion zurückgegebene Handle kann mit anderen erweiterten Metadateifunktionen verwendet werden.
Wenn der Kontext des Referenzgeräts nicht mit dem Gerät identisch ist, auf dem die Metadatei ursprünglich erstellt wurde, zeichnen einige GDI-Funktionen, die Geräteeinheiten verwenden, das Bild möglicherweise nicht ordnungsgemäß.
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 (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |