SetWinMetaFileBits-Funktion (wingdi.h)

Artikel
08/27/2023

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