CDC::SelectPalette
更新 : 2007 年 11 月
pPalette により指定される論理パレットをデバイス コンテキストの選択されたパレット オブジェクトとします。
CPalette* SelectPalette(
CPalette* pPalette,
BOOL bForceBackground
);
パラメータ
pPalette
選択される論理パレットを識別します。このパレットは、CPalette クラスの CreatePalette メンバ関数であらかじめ作成しておきます。bForceBackground
論理パレットを 2 次パレットとするかどうかを指定します。bForceBackground が 0 以外の値のときは、ウィンドウが入力フォーカスを持っているかどうかにかかわらず、選択されたパレットは常に 2 次パレットになります。bForceBackground が 0 であり、デバイス コンテキストが Windows に結び付けられている場合は、ウィンドウが入力フォーカスを持っているときに、論理パレットは優先表示パレットになります。
戻り値
pPalette で指定されたパレットで置き換えられた論理パレットを識別する CPalette オブジェクトへのポインタを返します。エラーが発生した場合は NULL を返します。
解説
新しいパレットは、直前のパレットに代わり、GDI がデバイス コンテキストに表示された色を管理するために使うパレット オブジェクトになります。
アプリケーションは、1 つの論理パレットを複数のデバイス コンテキストに対して選択できます。しかし、論理パレットに変更を加えると、そのパレットを選択しているすべてのデバイス コンテキストが影響を受けます。アプリケーションが、1 つのパレット オブジェクトを複数のデバイス コンテキストに対して選択するときは、それらデバイス コンテキストはすべて同じ物理デバイスに属している必要があります。
必要条件
ヘッダー : afxwin.h