GetNextDlgGroupItem 函式 (winuser.h)
擷取控制項群組中第一個控制項的控制碼，該控制項位於 (之前，或遵循) 對話方塊中指定的控制項。
語法
HWND GetNextDlgGroupItem(
[in] HWND hDlg,
[in, optional] HWND hCtl,
[in] BOOL bPrevious
);
參數
[in] hDlg
類型： HWND
要搜尋之對話方塊的控制碼。
[in, optional] hCtl
類型： HWND
要做為搜尋起點之控制項的控制碼。 如果此參數為 Null，函式會使用對話方塊中最後一個 (或第一個) 控制項做為搜尋的起點。
[in] bPrevious
類型： BOOL
指出函式如何搜尋對話方塊中的控制項群組。 如果此參數為 TRUE，函式會搜尋群組中的上一個控制項。 如果為 FALSE，函式會搜尋群組中的下一個控制項。
傳回值
類型： HWND
如果函式成功，則傳回值是控制項群組中上一個 (或下一個) 控制項的控制碼。
如果函式失敗，則傳回值為 Null。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
GetNextDlgGroupItem函式會依照在對話方塊範本中建立的順序 (或反向) 順序來搜尋控制項。 群組中的第一個控制項必須具有 WS_GROUP 樣式;群組中的所有其他控制項都必須連續建立，而且不能有 WS_GROUP 樣式。
搜尋上一個控制項時，函式會傳回它找到的第一個控制項，該控制項是可見且未停用的。 如果 hCtl 指定的控制項具有 WS_GROUP 樣式，則函式會暫時反轉搜尋，找出具有 WS_GROUP 樣式的第一個控制項，然後以原始方向繼續搜尋，傳回它找到的第一個控制項是可見且未停用的，如果找不到這類控制項，則傳回 hCtl 。
搜尋下一個控制項時，函式會傳回它找到的第一個控制項，該控制項為可見、未停用，而且沒有 WS_GROUP 樣式。 如果它遇到具有 WS_GROUP 樣式的控制項，則函式會反轉搜尋、找出具有 WS_GROUP 樣式的第一個控制項，並在可見且未停用時傳回此控制項。 否則，函式會以原始方向繼續搜尋，並傳回它找到的第一個控制項，如果找不到這類控制項，則傳回 hCtl 。
如果群組中下一個控制項的搜尋遇到具有 WS_EX_CONTROLPARENT 樣式的視窗，則系統會以遞迴方式搜尋視窗的子系。
規格需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winuser.h (包括 Windows.h) |
| 程式庫 | User32.lib |
| Dll | User32.dll |
另請參閱
概念
參考