Freigeben über


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

Weitere Informationen

Farbfunktionen

Übersicht über Farben

DeleteObject

GetDeviceCaps

LOGPALETTE

RealizePalette

SelectPalette