函式原型
B00L DrawlconEx(HDC hdc,int xLeft,int yTOp,HICON hlcon,int cxWidth,int cyWidth UINT isteplfAniCur,HBRUSH hbrFlickerFreeDraw,UINT diFlags);
參數介紹
hdc:視窗設備上下文的句柄。
xLeft:指定目標或游標左上角的邏輯x坐標。
yTop:指定圖示或游標左上角的邏輯y坐標。
hlcon:被繪製圖示的句柄,該參數可標識一個激活的游標。圖示或游標資源必須已經通過Loadlmage函式被裝載過。這參數能識別激活的游標。
cxWidth:指定圖示或游標的邏輯寬度。如果其值為零且diFlags參數是DI_DEFAULTSIZE;函式使用SM_CXICON或_CXCURSOR系統公制值設定寬度;如果其值為零且不使用DI_DEFAULTSIZE,函式使用資源實際寬度。
cyWidth:指定圖示或游標的邏輯高度。如果其值為零且diFlags參數是DI_DEFAULTSIZE,函式使用SM_CYICON或SM_CYCURSOR系統公制值設定高度;如果其值為零且不使用DI_DEFAULTSIZE,函式使用資源實際高isteplfAniCur:如果hlcon標識一個動態游標,參數指定要繪製的幀索引;如果hlcon不標識一個動態游標,該參數被忽略。
hbrFlickerFreeDraw:系統用做閃爍·自由繪圖的刷子句柄。如果hbrFlickerFreeDraw是有效的刷子句柄,系統利用背景顏色刷於創建一個反屏點陣圖將圖示或游標繪製到點陣圖中,並將點陣圖複製到由hdc。標識的設備上下文中。
diFlags:指定繪圖的標記,參數可為下列的值:
DI_COMPAT:系統採用預設圖像而不是用戶定義的圖像繪製圖示和游標。
DI_DEFAULTSIZE:如果CXWidth和CyWidth參數被設為零,採用系統指定的圖示和游標的的公制寬度和高 度繪製圖示和游標;如果標記未被指定且cxWidth和cyWith參數設為零標,函式使用資源實際大小。
DI_IMAGE:用圖像繪製目標或游標。DI_MASK:用禁止繪圖圖示或游標。
DL_NORMAL:DI_IMAGE 與DI_MASKR的組合。
返回值:如果函式成功,返回值是非零;如果函式失效返回值是零。想獲得更多的錯誤信息請調用GetLastError函式。
備註:DrawlconEx。函式將圖示的左上角置於由xLeft和yTop參數指定的位置,該位置受當前設備上下文的映射方式支配。
Windows CE:下列的參數設定必須被使用:
djFlags必須是DI_NORMAL,DI_IMAGE,或DI_MASK(不支持DI_COMPAT and DI_DEFAULTSIZE)。
cxWidth和cyHeight必須是零或圖示的原始尺寸。hbrFlickerFreeDraw必須是NULL。
iSteplfAniCur必須是零,動態圖示不被支援。Windows CE不支援:伸長的和壓縮:也就是說該圖示解析度對給定的HICON是固定的,不支持國標大小的再調整。映射方式:用DrawlconEx繪製游標時,hlcon參數不能標識動態游標。
速查:Windows NT:31及以上版本;Windows:95及以上版本;Windows CE:1.0及以上版本;頭檔案:winuser.h;庫檔案:user32.lib。