SelectPalette-Funktion (wingdi.h)

Artikel
08/27/2023

Die SelectPalette-Funktion wählt die angegebene logische Palette in einem Gerätekontext aus.

Syntax

HPALETTE SelectPalette(
  [in] HDC      hdc,
  [in] HPALETTE hPal,
  [in] BOOL     bForceBkgd
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] hPal

Ein Handle für die auszuwählende logische Palette.

[in] bForceBkgd

Gibt an, ob die logische Palette erzwungen wird, eine Hintergrundpalette zu sein. Wenn dieser Wert TRUE ist, bewirkt die RealizePalette-Funktion , dass die logische Palette den Farben, die sich bereits in der physischen Palette befinden, bestmöglich zugeordnet wird. Dies erfolgt immer, auch wenn das Fenster, für das die Palette realisiert wird, zu einem Thread ohne aktiven Fokus gehört.

Wenn dieser Wert FALSE ist, bewirkt RealizePalette , dass die logische Palette in die Gerätepalette kopiert wird, wenn sich die Anwendung im Vordergrund befindet. (Wenn der hdc-Parameter ein Speichergerätekontext ist, wird dieser Parameter ignoriert.)

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für die vorherige logische Palette des Gerätekontexts.

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.

Eine Anwendung kann nur dann eine logische Palette in mehreren Gerätekontexten auswählen, wenn Gerätekontexte kompatibel sind. Andernfalls schlägt SelectPalette fehl. Um einen Gerätekontext zu erstellen, der mit einem anderen Gerätekontext kompatibel ist, rufen Sie CreateCompatibleDC mit dem ersten Gerätekontext als Parameter auf. Wenn eine logische Palette in mehr als einem Gerätekontext ausgewählt wird, wirken sich Änderungen an der logischen Palette auf alle Gerätekontexte aus, für die sie ausgewählt ist.

Eine Anwendung kann die SelectPalette-Funktion aufrufen, wobei der bForceBackground-Parameter auf TRUE festgelegt ist, wenn die untergeordneten Fenster eines Fensters der obersten Ebene jeweils ihre eigenen Paletten realisieren. Allerdings muss nur das untergeordnete Fenster, das seine Palette erkennen muss, bForceBackground auf TRUE festlegen. Andere untergeordnete Fenster müssen diesen Wert auf FALSE festlegen.

Anforderungen

Anforderung	Wert
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