リスト ボックス

ここでは、リスト ボックスで使用されるプログラミング要素について説明します。 リスト ボックスは、ユーザーが選択できるアイテムの単純なリストを含むコントロール ウィンドウです。 より複雑なリストの場合は、代わりにリスト ビューを使用します。

概要

トピック 内容
リスト ボックスについて リスト ボックスの機能について説明します。
リスト ボックスの使用 リスト ボックスに関連付けられているタスクを実行する方法について説明します。

関数

トピック 内容
DlgDirList リスト ボックスの内容を、指定されたディレクトリ内のサブディレクトリとファイルの名前に置き換えます。
DlgDirSelectEx 単一選択肢のリスト ボックスから現在の選択肢を取得します。
DrawInsert 指定したドラッグ リスト ボックスの親ウィンドウに挿入アイコンを描画します。
GetListBoxInfo 指定されたリスト ボックスの情報を取得します。
LBItemFromPt リスト ボックス内の指定したポイントにあるアイテムのインデックスを取得します。
MakeDragList 指定した単一選択肢リスト ボックスをドラッグ リスト ボックスに変更します。

[メッセージ]

トピック 内容
LB_ADDFILE 指定したファイル名を、ディレクトリ一覧を含むリスト ボックスに追加します。
LB_ADDSTRING リスト ボックスに文字列を追加します。
LB_DELETESTRING リスト ボックス内の文字列を削除します。
LB_DIR リスト ボックスによって表示されるリストに名前を追加します。
LB_FINDSTRING リスト ボックス内で、指定した文字列で始まる最初の文字列を検索します。
LB_FINDSTRINGEXACT 指定の文字列と一致する最初のリスト ボックス文字列を検索します。ただし、この検索では大文字と小文字が区別されません。
LB_GETANCHORINDEX アンカー アイテムのインデックスを取得します。つまり、複数選択が開始されるアイテムです。
LB_GETCARETINDEX 複数選択リスト ボックスにフォーカスの矩形があるアイテムのインデックスを取得します。 アイテムが選択されている場合と選択されていない場合があります。
LB_GETCOUNT リスト ボックス内のアイテム数を取得します。
LB_GETCURSEL 現在選択されているアイテム (存在する場合) のインデックスを単一選択リスト ボックスで取得します。
LB_GETHORIZONTALEXTENT リスト ボックスに水平スクロール バーがある場合に、リスト ボックスを水平方向にスクロールできる幅 (スクロール可能な幅) をピクセル単位で取得します。
LB_GETITEMDATA 指定されたリスト ボックス アイテムに関連付けられているアプリケーション定義の値を取得します。
LB_GETITEMHEIGHT リスト ボックス内のアイテムの高さを取得します。
LB_GETITEMRECT リスト ボックスで現在表示されている場合、リスト ボックス アイテムに固定されている矩形の寸法を取得します。
LB_GETLISTBOXINFO 指定したリスト ボックス内の列あたりのアイテム数を取得します。
LB_GETLOCALE リスト ボックスの現在のロケールを取得します。
LB_GETSEL アイテムの選択状態を取得します。
LB_GETSELCOUNT 複数選択リスト ボックス内の選択したアイテムの合計数を取得します。
LB_GETSELITEMS 複数選択リスト ボックスで選択したアイテムのアイテム番号を指定する整数の配列をバッファーに格納します。
LB_GETTEXT リスト ボックスから文字列を取得します。
LB_GETTEXTLEN リスト ボックス内の文字列の長さを取得します。
LB_GETTOPINDEX リスト ボックスに最初に表示されるアイテムのインデックスを取得します。
LB_INITSTORAGE リスト ボックス アイテムを格納するためのメモリを割り当てます。 このメッセージは、アプリケーションが多数のアイテムをリスト ボックスに追加する前に使用されます。
LB_INSERTSTRING リスト ボックスに文字列またはアイテム データを挿入します。 LB_ADDSTRING とは異なり、LB_INSERTSTRING メッセージは、LBS_SORT スタイルのリストを並べ替えることはありません。
LB_ITEMFROMPOINT リスト ボックス内の指定したポイントに最も近い項目の 0 から始まるインデックスを取得します。
LB_RESETCONTENT リスト ボックスからすべてのアイテムを削除します。
LB_SELECTSTRING 指定された文字列で始まるアイテムをリスト ボックスで検索します。
LB_SELITEMRANGE 複数選択リスト ボックス内の 1 つ以上の連続する項目を選択または選択解除します。
LB_SELITEMRANGEEX 複数選択リスト ボックス内の 1 つ以上の連続するアイテムを選択します。
LB_SETANCHORINDEX アンカー アイテムのインデックスを設定します。つまり、複数選択が開始されるアイテムです。 複数選択は、アンカー アイテムからキャレット アイテムまでのすべてのアイテムにまたがっています。
LB_SETCARETINDEX 複数選択リスト ボックスの指定したインデックスにあるアイテムにフォーカス矩形を設定します。 アイテムが表示されていない場合は、ビューにスクロールされます。
LB_SETCOLUMNWIDTH 複数列リスト ボックス内のすべての列の幅をピクセル単位で設定します。
LB_SETCOUNT LBS_NODATA スタイルで作成され、LBS_HASSTRINGS スタイルで作成されていないリスト ボックス内のアイテム数を設定し、
LB_SETCURSEL 文字列を選択し、必要に応じてビューにスクロールします。
LB_SETHORIZONTALEXTENT リスト ボックスを水平方向にスクロールできる幅 (スクロール可能な幅) をピクセル単位で設定します。
LB_SETITEMDATA リスト ボックス内の指定したアイテムに関連付けられている値を設定します。
LB_SETITEMHEIGHT リスト ボックス内のアイテムの高さをピクセル単位で設定します。
LB_SETLOCALE リスト ボックスの現在のロケールを設定します。
LB_SETSEL 複数選択リスト ボックスで文字列を選択します。
LB_SETTABSTOPS リスト ボックス内のタブ停止位置を設定します。
LB_SETTOPINDEX リスト ボックス内に指定したアイテムが表示されることを確認します。

通知

トピック 内容
LBN_DBLCLK ユーザーがリスト ボックス内の項目をダブルクリックしたことをアプリケーションに通知します。
LBN_ERRSPACE リスト ボックスが特定の要求を満たすのに十分なメモリを割り当てることができないことをアプリケーションに通知します。
LBN_KILLFOCUS リスト ボックスがキーボード フォーカスを失ったことをアプリケーションに通知します。
LBN_SELCANCEL ユーザーがリスト ボックスの選択を取り消したことをアプリケーションに通知します。
LBN_SELCHANGE リスト ボックス内の選択が変更されたことをアプリケーションに通知します。
LBN_SETFOCUS リスト ボックスにキーボード フォーカスが当たったことをアプリケーションに通知します。
WM_CHARTOITEM WM_CHAR メッセージへの応答として、LBS_WANTKEYBOARDINPUT スタイルのリスト ボックスによって所有者に送信されます。
WM_CTLCOLORLISTBOX リスト ボックスを描画する前に、リスト ボックスの親ウィンドウに送信されます。 このメッセージに応答することで、親ウィンドウは、指定された表示デバイス コンテキスト ハンドルを使用して、リスト ボックスのテキスト色と背景色を設定できます。
WM_DELETEITEM リスト ボックスまたはコンボ ボックスが破棄された、またはアイテムが LB_DELETESTRINGLB_RESETCONTENTCB_DELETESTRING または CB_RESETCONTENT メッセージによって削除された場合、リスト ボックスまたはコンボ ボックスの所有者に送信します。
WM_VKEYTOITEM WM_KEYDOWN メッセージへの応答として、LBS_WANTKEYBOARDINPUT スタイルのリスト ボックスによってオーナーに送信されます。
DL_BEGINDRAG ドラッグ リスト ボックスの親ウィンドウに、ユーザーがマウスの左ボタン使ってアイテムをクリックしたことを通知します。
DL_CANCELDRAG マウスの右ボタンをクリックするか Esc キーを押して、ユーザーがドラッグ操作をキャンセルしたことを通知します。
DL_DRAGGING アイテムのドラッグ中にユーザーがマウスを動かしたことを通知します。
DL_DROPPED ユーザーがマウスの左ボタンを離してドラッグ操作を完了したことを通知します。

構造体

トピック 内容
DELETEITEMSTRUCT 削除されたリスト ボックスまたはコンボ ボックス アイテムに関する情報が含まれます。
DRAGLISTINFO ドラッグ イベントに関する情報が含まれます。 DRAGLISTINFO へのポインターは、ドラッグ リスト メッセージの lParam パラメーターとして渡されます。

定数

トピック 内容
リスト ボックス スタイル リスト ボックス コントロールを定義するウィンドウ スタイルについて説明します。