ListBox_SetCaretIndex マクロ (windowsx.h)

複数選択リスト ボックスの指定したインデックス位置にある項目にフォーカス四角形を設定します。 項目が表示されていない場合は、ビューにスクロールされます。 このマクロを使用することも、LB_SETCARETINDEX メッセージを明示的に送信することもできます。

構文

int ListBox_SetCaretIndex(
   HWND hwndCtl,
   int  index
);

パラメーター

hwndCtl

型: HWND

コントロールのハンドル。

index

型: int

フォーカスの四角形を受け取るリスト ボックス項目の 0 から始まるインデックス。

戻り値

型: int

エラーが発生した場合、戻り値はLB_ERR。

備考

リスト ボックスの内容は、項目が完全に表示されるまでスクロールされます。

詳細については、LB_SETCARETINDEXを参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	windowsx.h