RealizePalette

該函數從當前邏輯調色板中映射調色板入口點到系統調色板中。

UINT RealizePalette(HDC hdc)；

hdc：設備環境句柄。一個邏輯調色板被選擇在該設備環境中。

如果函數成功，函數返回值為入口點的數目，這些邏輯調色板中的入口點映射到系統調色板中；如果失敗，返回值是GDI_ERROR。

Windows NT：若想獲得更多錯誤信息，請調用GetLastError函數。

通過調用GetDeviceCaps函數和定義RASTERCAPS常量。一個應用可以確定一個設備是否支持調色板操作。

RealizePalette函數修改與指定設備環境有關的設備的調色板，如果該設備環境是一個內存設備環境，那麼選進該設備環境的位圖顏色表將被修改，如果該設備環境是真實顯示設備環境，那麼該設備的物理調色板將被修改。

邏輯顏色調色板是顏色密集型應用和系統之間的一個緩存，允許這些應用在不干擾其他窗口顏色的情況下使用任意多的顏色。

當焦點在一個應用窗口，並且它調用RealizePalette函數時，則系統試圖映射儘可能多的顏色，這對於活動窗口的應用也同樣正確。

Windows CE：Windows CE在前景和背景調色板應用之間並不做出仲裁，前景應用完全控制了系統調色板，因此，對於前景應用Windows CE並不執行任何顏色匹配操作。它僅僅用hdc參數的調色板入口點來覆蓋系統調色板的入口點。

Windows CE背景應用中不支持RealizePalette函數。

如果與hdc相關的設備設置一個可設置的調色板，那麼RealizePalette函數將執行失敗，在使用RealizePaletle函數之前，先調用GetDevicecaps函數來斷定一個設備是否有一個可設置的調色板。

Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：2.0及以上版本；頭文件：wingdi.h；庫文件：gdi32.lib。