RealizePalette

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。

相關詞條

相關搜尋

熱門詞條

聯絡我們