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 |