SelectPalette,函式,用於實現選擇指定的邏輯調色板到一個設備環境中。
基本介紹
- 中文名:SelectPalette
- hdc:設備環境句柄
- hpal:標識被選擇的邏輯調色板
- 函式功能:指定的邏輯調色板到一個設備環境
函式原型,參數,返回值,注釋,速查,
函式原型
HPALETTE SelectPalette(HDC hdc, HPALETTE hpal, BOOL bForceBackground);
參數
hdc:設備環境句柄。
hpal:標識被選擇的邏輯調色板。
bForceBackground:確定邏輯調色板是否被強行作為一個背景調色板,如果該值為TRUE RealizePalette函式就使邏輯調色板以最好的可能方式映射成物理調色板中已有的顏色,這種情況常發生;如果該值為FALSE,RealizePalette使邏輯調色板拷貝到設備調色板中,這時該套用在前景(如果hdc參數是一個記憶體設備環境,該參數被忽略)。
返回值
如果成功,返回值和設備環境以前的邏輯調色板相一致;如果失敗返回值為NULL。
Windows NT:若想獲得更多錯誤信息,請調用GetLastError函式。
注釋
通過調用GetDevicecaps函式和定義RASTERCaps常數,一個套用可以確定一個設備是否支持調色板操作。
一個套用可以把一個邏輯調色板選入多個設備環境中,邏輯調色板的變化會影響所有的設備環境。
如果一個頂層視窗的每一個子視窗都映射自己的調色板,那么一個套用就可以在bForceBackground參數設為TRUE的情況下調用SelectPalette。但是只有需要映射它的調色板的子視窗必須把bForceBackground置為TRUE,其他的子視窗必須把該值設為FALSE。
Windows CE:Windows CE在前景套用和背景套用的調色板之間不做仲裁,因此WindowsCE忽略bForceBackground參數,把它當作始終是FALSE。
速查
Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:2.0及以上版本;頭檔案:wingdi.h;庫檔案:gdi32.lib。