GetEnhMetaFilePaletteEntries-Funktion (wingdi.h)
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 |