RealizePalette，一種函式，該函式從當前邏輯調色板中映射調色板入口點到系統調色板中。
基本介紹
- 外文名：RealizePalette
- 函式原型：UINT RealizePalette(HDC hdc)
- 參數：hdc：設備環境句柄
- 調色板：顏色密集型套用和系統之間的快取
函式功能,函式原型,參數,返回值,注釋,速查,
函式功能
該函式從當前邏輯調色板中映射調色板入口點到系統調色板中。
函式原型
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。
