GetEnhMetaFilePaletteEntries-Funktion (wingdi.h)

Artikel
08/27/2023

Die GetEnhMetaFilePaletteEntries-Funktion ruft optionale Paletteneinträge aus der angegebenen erweiterten Metadatei ab.

Syntax

UINT GetEnhMetaFilePaletteEntries(
  [in]  HENHMETAFILE   hemf,
  [in]  UINT           nNumEntries,
  [out] LPPALETTEENTRY lpPaletteEntries
);

Parameter

[in] hemf

Ein Handle für die erweiterte Metadatei.

[in] nNumEntries

Die Anzahl der Einträge, die aus der optionalen Palette abgerufen werden sollen.

[out] lpPaletteEntries

Ein Zeiger auf ein Array von PALETTEENTRY-Strukturen , das die Palettenfarben empfängt. Das Array muss mindestens so viele Strukturen enthalten, wie vom cEntries-Parameter angegebene Einträge vorhanden sind.

Rückgabewert

Wenn der Arrayzeiger NULL ist und die erweiterte Metadatei eine optionale Palette enthält, ist der Rückgabewert die Anzahl der Einträge in der Palette der erweiterten Metadatei. wenn der Arrayzeiger ein gültiger Zeiger ist und die erweiterte Metadatei eine optionale Palette enthält, ist der Rückgabewert die Anzahl der kopierten Einträge. wenn die Metadatei keine optionale Palette enthält, ist der Rückgabewert 0. Andernfalls wird der Rückgabewert GDI_ERROR.

Hinweise

Eine Anwendung kann eine optionale Palette in einer erweiterten Metadatei speichern, indem sie die Funktionen CreatePalette und SetPaletteEntries aufruft , bevor das Bild erstellt und in der Metadatei gespeichert wird. Auf diese Weise kann die Anwendung konsistente Farben erzielen, wenn das Bild auf einer Vielzahl von Geräten angezeigt wird.

Eine Anwendung, die ein in einer erweiterten Metadatei gespeichertes Bild anzeigt, kann die GetEnhMetaFilePaletteEntries-Funktion aufrufen, um zu bestimmen, ob die optionale Palette vorhanden ist. Wenn dies der Fall ist, kann die Anwendung die GetEnhMetaFilePaletteEntries-Funktion ein zweites Mal aufrufen, um die Paletteneinträge abzurufen, und dann eine logische Palette erstellen (mithilfe der CreatePalette-Funktion ), sie in ihren Gerätekontext auswählen (mithilfe der SelectPalette-Funktion ) und dann (mithilfe der Funktion RealizePalette ) realisieren. Nachdem die logische Palette realisiert wurde, zeigt der Aufruf der PlayEnhMetaFile-Funktion das Bild in seinen ursprünglichen Farben an.

Anforderungen


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