GetNextDlgGroupltem

GetNextDlgGroupltem是一種函式,功能是該函式檢索控制組的第一個控制的句柄,該控制組跟隨對話框中指定的控制。

函式原型

HWND GetNextDlgGroupltem(HWND hDlg,HWND hctl,BOOL bPrevious);

參數

hDlg:標識正在被搜尋的對話框。

hCtl:指定用來作為搜尋開始點的控制項。如果此參數為空,函式將以最後一個控制項為搜尋開始點。

BPrevious:指定參數如何搜尋,如果此參數為TRUE,則函式尋找以前的控制項組中的控制項。如果為FALSE,則函式尋找控制項組中的下一個控制項。

返回值:如果GetNextDlgGroupltem函式調用成功,則返回值為控制項組中以前的(或下一個)控制項。如果函式調用失敗,則返回值為零。若想獲得更多的錯誤信息,請調用GetLastError函式。

備往:GetNextDlgGroupltem函式按照對話框模板中被創建的順序(或相反的順序)尋找控制項。控制項組的第一個控制項一定有WS_GROUP類型;所有其他的控制項組的控制項一定被順序創建且一定沒有WS_GROUP類型。

當尋找以前的控制項時,函式返回第一個位置上可視的、且不失效的控制。如果由hCtl給定的控制項有WS_GROUP類型,則函式暫時反向尋找具有WS_GROUP類型的第一個控制項,然後重新回到原來的方向進行尋找,返回可視的、且不失效的第一個控制項,如果沒有發現控制項,則返回hWndCtrl。

當尋找下一個控制項時,函式返回第一個位置上的可視控制項,且沒有WS_GROUP類型。如果遇到一個有WS_GROUP類型的控制項,則函式反向尋找具有WS_GROUP類型的第一個控制項,且如果此控制項為可視的、且沒有失效,則返回此控制項。否則,函式重新回到原來方向的尋找,返回可視的、且不失效的第一個控制項。如果沒有發現控制項。則返回hCtl。

速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:1.0及以上版本;頭檔案:winuser.h;庫檔案:user32.lib。

相關詞條

相關搜尋

熱門詞條

聯絡我們