CreatePalette-Funktion (wingdi.h)
Die CreatePalette-Funktion erstellt eine logische Palette.
Syntax
HPALETTE CreatePalette(
[in] const LOGPALETTE *plpal
);
Parameter
[in] plpal
Ein Zeiger auf eine LOGPALETTE-Struktur , die Informationen zu den Farben in der logischen Palette enthält.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für eine logische Palette.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.
Hinweise
Eine Anwendung kann ermitteln, ob ein Gerät Palettenvorgänge unterstützt, indem sie die GetDeviceCaps-Funktion aufruft und die RASTERCAPS-Konstante angibt.
Sobald eine Anwendung eine logische Palette erstellt hat, kann sie diese Palette in einem Gerätekontext auswählen, indem sie die SelectPalette-Funktion aufruft. Eine in einen Gerätekontext ausgewählte Palette kann durch Aufrufen der RealizePalette-Funktion realisiert werden.
Wenn Sie die Palette nicht mehr benötigen, rufen Sie die DeleteObject-Funktion auf, um sie zu löschen.
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 (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |