函式功能
函式功能:該函式從與指定設備環境有關係的系統調色板中檢取調色板入口點的範圍。
函式原型:UINT GetSystemPaletteEntries(HDC hdc, UINT iStartIndex, UINT nEntries, LPPALETTEENTRY lppe);
相關參數
參數:
hdc:設備環境句柄。
iStartIndex:指定從系統調色板中檢取的第一個入口點。
nEntries:指定從系統調色板中檢取入口點的數目。
lppe:指向PALETTEENTRY結構數組的指針,它檢取調色板入口點,該數組至少要包含由nEntries參數所指定的結構數,如果該參數為NULL(空),則該函式返回調色板中入口點的總數。
返回值:如果函式執行成功,返回值是從調色板中檢取的入口點數;如果失敗,返回值為零。
Windows NT:若想獲得更多錯誤信息,請調用GetLastError函式。
注釋:通過調用GetDeviceCaps函式和定義RASTERCAPS常用量,一個套用可以確定一個設備是否支持調色板操作。
Windows CE:如果和hdc相關的設備沒有一個可設定的調色板,那么GetSystemPaletteEntries函式就會失敗,在使用GetsystempaletteEntries之前,可使用GetDeviceCaps函式來確定考查該設備是否有一個可設定的調色板。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:2.0及以上版本;頭檔案:wingdi.h;庫檔案:gdi32.lib。