Freigeben über


CDC::SelectPalette

Wählt die Logische Palette aus, die von pPalette als das ausgewählte Palettenobjekt des Gerätekontexts angegeben wird.

CPalette* SelectPalette( 
   CPalette* pPalette, 
   BOOL bForceBackground  
);

Parameter

  • pPalette
    Identifiziert die ausgewählt werden Logische Palette. Diese Palette muss mit der CPalette-Memberfunktion CreatePalette bereits erstellt worden sein.

  • bForceBackground
    Gibt an, ob die Logische Palette erzwungen wird, um eine Hintergrundpalette zu sein. Wenn bForceBackground ungleich 0 ist, ist die ausgewählte Palette immer eine Hintergrundpalette, unabhängig davon, ob das Fenster den Eingabefokus hat. Wenn bForceBackground 0 und der Gerätekontext zu einem Fenster angefügt wird, ist die Logische Palette eine Vordergrundpalette, wenn das Fenster den Eingabefokus hat.

Rückgabewert

Ein Zeiger auf ein Objekt, das die CPalette Logische Palette ersetzt durch die Palette angegeben durch pPalette identifiziert. Es ist NULL, wenn ein Fehler auftritt.

Hinweise

Die neue Palette wird das Palettenobjekt, das von GDI zu den Steuerelement wird verwendet wird, die im Gerätekontext angezeigt und ersetzt die vorherige Palette.

Eine Anwendung kann eine Logische Palette in mehr als einem Gerätekontext auswählen. jedoch beeinflussen Änderungen an einer Logischen Palette alle Gerätekontexte, für die es ausgewählt wird. Wenn eine Anwendung eine Palette in mehr als einem Gerätekontext auswählt, müssen alle Gerätekontexte demselben physischen Gerät gehören.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchiediagramm

CDC::RealizePalette

CPalette-Klasse

SelectPalette