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 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll

関連項目

概念

ダイアログ ボックス

GetNextDlgTabItem

参照