函式功能
函式功能:該函式為一個邏輯調色板的入口點數組設定RGB顏色值和標誌。
函式原型:UINT SetPaletteEntries(HPALETTE hpal, UINT iStart, UINT cEntries, CONST PALETTEENTRY *lppe);
參數
參數:
hpal:標識邏輯調色板。
iStart:指定第一個被設定的邏輯調色板入口點。
cEntries:指定被設定的邏輯調色板的入口點數目。
lppe:指向包含RGB值和標誌的PALETTEENTRY結構數組的第一個元素。
返回值:如果成功,返回值是邏輯調色板中設定的入口點數目;如果失敗,返回值為零。
Windows NT:若想獲得更多錯誤的信息,請調用GetLastError函式。
注釋:通過調用GetDeviceCaps函式和定義RASTERCAPS常數,一個套用可以確定一個設備是否支持調色板操作。
如果一個邏輯調色板已被選擇並且被映射,那么該調色板的變化並不影響外部的物理調色板,RealizePalette必須重新被調用以設定一個新的邏輯調色板到外部。
Windows CE:如果startindex調色板入口點數目大。那么setpalettEntries函式將執行失敗。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:2.0及以上版本;頭檔案:wingdi.h;庫檔案:gdi32.lib。