GetNextDlgTabItem 関数 (winuser.h)

  • [アーティクル]

指定したコントロールの前 (またはそれに続く) WS_TABSTOP スタイルを持つ最初のコントロールへのハンドルを取得します。

構文

HWND GetNextDlgTabItem(
  [in]           HWND hDlg,
  [in, optional] HWND hCtl,
  [in]           BOOL bPrevious
);

パラメーター

[in] hDlg

型: HWND

検索するダイアログ ボックスへのハンドル。

[in, optional] hCtl

型: HWND

検索の開始点として使用するコントロールへのハンドル。 このパラメーターが NULL の場合、関数は失敗します。

[in] bPrevious

種類: BOOL

関数がダイアログ ボックスを検索する方法を示します。 このパラメーターが TRUE の場合、関数はダイアログ ボックスで前のコントロールを検索します。 このパラメーターが FALSE の場合、関数はダイアログ ボックスで次のコントロールを検索します。

戻り値

型: HWND

関数が成功した場合、戻り値は、 WS_TABSTOP スタイルが設定されている前の (または次の) コントロールのウィンドウ ハンドルです。

関数が失敗した場合は、返される値は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

GetNextDlgTabItem 関数は、ダイアログ ボックス テンプレートで作成された順序 (または逆順) でコントロールを検索します。 この関数は、表示され、無効ではなく、 WS_TABSTOP スタイルを持つ最初のコントロールを返します。 このようなコントロールが存在しない場合、この関数は hCtl を返します。

WS_TABSTOP スタイルを持つ次のコントロールを検索すると、WS_EX_CONTROLPARENT スタイルのウィンドウが検出された場合、システムはウィンドウの子を再帰的に検索します。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll
API セット ext-ms-win-ntuser-dialogbox-l1-1-2 (Windows 10 バージョン 10.0.10240 で導入)

関連項目

概念

ダイアログ ボックス

GetDlgItem

GetNextDlgGroupItem

参照