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

另請參閱

概念

對話方塊

GetNextDlgTabItem

參考