共用方式為


RealizePalette 函式 (wingdi.h)

RealizePalette函式會將調色盤專案從目前的邏輯調色盤對應至系統調色盤。

語法

UINT RealizePalette(
  [in] HDC hdc
);

參數

[in] hdc

已選取邏輯調色盤之裝置內容的控制碼。

傳回值

如果函式成功,則傳回值是對應至系統調色盤之邏輯調色盤中的專案數。

如果函式失敗,傳回值會GDI_ERROR。

備註

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

RealizePalette函式會修改與指定裝置內容相關聯之裝置的調色盤。 如果裝置內容是記憶體 DC,則會修改選取至 DC 之點陣圖的色彩表格。 如果裝置內容是顯示 DC,則會修改該裝置的實體調色盤。

邏輯調色盤是大量色彩應用程式與系統之間的緩衝區,可讓這些應用程式視需要使用任意數量的色彩,而不會干擾其他視窗所顯示的色彩。

當應用程式的視窗有焦點且呼叫 RealizePalette 函式時,系統會嘗試盡可能實現所要求的色彩數目。 對於具有非作用中視窗的應用程式,也是如此。

規格需求

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

另請參閱

色彩函式

色彩概觀

CreatePalette

GetDeviceCaps

SelectPalette