CreatePalette-Funktion (wingdi.h)

Artikel
08/27/2023

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