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 |
関連項目
概念
参照