selectPalette 函式 (wingdi.h)

發行項
03/04/2024

SelectPalette 函式會將指定的邏輯選擇區選取到裝置內容中。

語法

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

參數

[in] hdc

裝置內容的句柄。

[in] hPal

要選取之邏輯調色盤的句柄。

[in] bForceBkgd

指定邏輯調色盤是否強制成為背景調色盤。如果此值為 TRUE，則 RealizePalette 函式會讓邏輯調色盤以最佳可能的方式對應至已在實體調色盤中的色彩。這一律會完成，即使調色盤實現所在的窗口屬於沒有作用中焦點的線程也一樣。

如果此值為 FALSE，RealizePalette 會在應用程式位於前景時，將邏輯調色盤複製到裝置調色盤中。 (如果 hdc 參數是記憶體裝置內容，則會忽略此參數。)

傳回值

如果函式成功，則傳回值是裝置內容先前邏輯調色盤的句柄。

如果函式失敗，傳回值為 NULL。

備註

應用程式可以呼叫 GetDeviceCaps 函式並指定 RASTERCAPS 常數，來判斷裝置是否支援調色盤作業。

只有在裝置內容相容時，應用程式才能在多個裝置內容中選取邏輯選擇區。否則 SelectPalette 會失敗。若要建立與另一個裝置內容相容的裝置內容，請使用第一個裝置內容作為參數呼叫 CreateCompatibleDC 。如果邏輯調色盤選取為多個裝置內容，則邏輯調色盤的變更會影響其選取的所有裝置內容。

如果最上層視窗的子視窗各自實現自己的調色盤，應用程式可能會呼叫具有 bForceBackground 參數設定為 TRUE 的 SelectPalette 函式。不過，只有需要實現其調色盤的子窗口必須將 bForceBackground 設定為 TRUE;其他子窗口必須將此值設定為 FALSE。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll