函式原型
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。