CListBox クラス
Windows のリスト ボックスの機能を提供します。
class CListBox : public CWnd
メンバー
.gif "y04ez4c9.collapse_all(ja-jp,VS.110).gif")
パブリック コンストラクター
名前 |
説明 |
|---|---|
CListBox オブジェクトを構築します。 |
パブリック メソッド
名前 |
説明 |
|---|---|
リスト ボックスに文字列を追加します。 |
|
文字列処理を持たないオーナー描画リスト ボックスにカスタム WM_CHAR を提供するためにオーバーライドします。 |
|
並べ替えられたオーナー描画リスト ボックスに新しいアイテムの位置を判断するために、フレームワークによって呼び出されます。 |
|
Windows のリスト ボックスを作成し、CListBox のオブジェクトにアタッチします。 |
|
ユーザーがオーナー描画リスト ボックスから項目を削除するときに、フレームワークによって呼び出されます。 |
|
リスト ボックスから文字列を削除します。 |
|
ファイル名、ドライブ、または現在のディレクトリからのリスト ボックスに両方を追加します。 |
|
オーナー描画リスト ボックスの外観が変更されたときに、フレームワークによって呼び出されます。 |
|
リスト ボックス内の文字列を検索します。 |
|
指定した文字列に一致する最初のリスト ボックスの文字列を検索します。 |
|
リスト ボックスで現在のアンカーの項目のインデックスを取得します。 |
|
複数選択リスト ボックスにフォーカスを示す四角形を持つ項目のインデックスを指定します。 |
|
リスト ボックス内の文字列数を返します。 |
|
リスト ボックスで現在選択されている文字列のインデックスを返します。 |
|
リスト ボックスは水平にスクロールできるピクセル幅を返します。 |
|
リスト ボックスの項目に関連付けられた 32 ビット値を返します。 |
|
リスト ボックスの項目へのポインターを返します。 |
|
リスト ボックスの項目の高さが決まります。 |
|
現在表示されているときにリスト ボックスの項目の外接する四角形を返します。 |
|
列ごとの項目数を取得します。 |
|
リスト ボックスのロケール識別子を取得します。 |
|
リスト ボックスの項目の選択状態を返します。 |
|
現在複数選択リスト ボックスで選択された文字列の数を返します。 |
|
現在リスト ボックスで選択された文字列のインデックスを返します。 |
|
バッファーにリスト ボックスの項目をコピーします。 |
|
リスト ボックスの項目のバイトの長さを返します。 |
|
リスト ボックスの最初に表示される文字列のインデックスを返します。 |
|
リスト ボックスの項目と文字列のメモリ ブロックを割り当てします。 |
|
リスト ボックス内の特定の場所に文字列を追加します。 |
|
リスト ボックスの項目のインデックスを返します。最も近いポイント |
|
リスト ボックスのサイズを決定するためにオーナー描画リスト ボックスが作成されるときに、フレームワークによって呼び出されます。 |
|
リスト ボックスからすべてのエントリを削除します。 |
|
検索での単一選択リスト ボックス内の文字列を選択します。 |
|
複数選択リスト ボックスの文字列の範囲を選択または選択解除します。 |
|
複数選択リスト ボックスでアンカーを拡張オプションを開始するように設定します。 |
|
複数選択リスト ボックスで指定したインデックス位置にある項目にフォーカスを示す四角形を設定します。 |
|
複数列リスト ボックスの列幅を設定します。 |
|
リスト ボックス内の文字列を選択します。 |
|
リスト ボックスは水平にスクロールできるピクセル幅を設定します。 |
|
32 ビット値をリスト ボックスの項目に関連付けられる。 |
|
リスト ボックスの項目へのポインターを設定します。 |
|
リスト ボックスの項目の高さを設定します。 |
|
リスト ボックスのロケール識別子を設定します。 |
|
複数選択リスト ボックスのリスト ボックスの項目を選択または選択解除します。 |
|
リスト ボックスのタブ ストップ位置を設定します。 |
|
リスト ボックスの最初に表示される文字列のインデックスを設定します。 |
|
処理 LBS_WANTKEYBOARDINPUT スタイルのセットをリスト ボックスにカスタム WM_KEYDOWN に提供します。 |
解説
リスト ボックスは、項目の一覧を表示し、ユーザーが選択できるファイル名などの表示します。
単一選択リスト ボックスで、ユーザーは 1 項目のみを選択できます。複数選択リスト ボックスで、項目の範囲を選択できます。ユーザーが項目を選択すると、リスト ボックスの親ウィンドウへ送信の通知メッセージ強調表示されます。
ダイアログ テンプレートから直接またはコードのリスト ボックスを作成できます。それを直接作成して、[作成] のメンバー関数を Windows のリスト ボックス コントロールを作成するために呼び出すように、CListBox のオブジェクトを構築し、CListBox のオブジェクトにアタッチする。リスト ボックスは、ダイアログ ボックス クラスのリスト ボックスの変数を次に、ダイアログ ボックス クラスの DoDataExchange 関数で DDX_Control をコントロールにメンバー変数を接続するように宣言するダイアログ テンプレートで使用します。(これは、のためのダイアログ ボックス クラスに制御変数を追加したときに自動的に処理されます)。
構造体は CListBoxから派生したクラスのワンの手順プロセスです。派生クラスのコンストラクターを書き込み、コンストラクター内で [作成] を呼び出します。
親 (通常は CDialogの派生クラス) にリスト ボックスに送られた Windows の通知メッセージを処理するには、各メッセージの親クラスにメッセージ マップのエントリとメッセージ ハンドラー メンバー関数を追加します。
各メッセージ マップのエントリは次の形式を持ちます。
ON_Notification( id, memberFxn )
id が送信するリスト ボックス コントロールの子ウィンドウ ID を指定します。memberFxn は、通知と通知を処理する、記述された親メンバー関数の名前です。
親の関数のプロトタイプは次のようになります。
afx_msg void memberFxn( );
ここでは、親に送信される場合の有効なメッセージ マップのエントリと説明の一覧です:
ON_LBN_DBLCLK ユーザーがリスト ボックス内の文字列をダブルクリックします。LBS_NOTIFY のスタイルがあるリスト ボックスだけこの通知メッセージを送信します。
ON_LBN_ERRSPACE は、リスト ボックス要求に対して十分なメモリを割り当てることはできません。
ON_LBN_KILLFOCUS リスト ボックスが入力フォーカスを失うことを通知します。
ON_LBN_SELCANCEL は、現在のリスト ボックスで選択キャンセルされます。このメッセージは、リスト ボックスに LBS_NOTIFY のスタイルがある場合にのみ送信されます。
リスト ボックスで選択が変更されたON_LBN_SELCHANGE。この通知は、オプションが CListBox::SetCurSel のメンバー関数によって変更される送信されません。この通知は LBS_NOTIFY のスタイルがあるリスト ボックスにのみ適用されます。LBN_SELCHANGE の通知メッセージは、複数選択リスト ボックスのオプションが変更されていない場合でも、ユーザーは方向キーを押したときに渡されます。
ON_LBN_SETFOCUS リスト ボックスが入力フォーカスを受け取ろうします。
ON_WM_CHARTOITEM は、文字列を持たないオーナー描画リスト ボックス WM_CHAR のメッセージを受信します。
LBS_WANTKEYBOARDINPUT のスタイルのON_WM_VKEYTOITEM A のリスト ボックスが WM_KEYDOWN のメッセージを受信します。
ダイアログ ボックス内に (ダイアログ リソースを使って) CListBox オブジェクトを作成したときは、ダイアログ ボックスを閉じたときに CListBox オブジェクトは自動的に破棄されます。
ウィンドウ内の CListBox のオブジェクトを作成する場合は、CListBox オブジェクトを破棄する必要があります。CListBox オブジェクトをスタック上に作成したときは、自動的に破棄されます。new 関数を使ってヒープ領域の CListBox のオブジェクトを作成する場合は、ユーザーが親ウィンドウを閉じるときに破棄するオブジェクトの [削除] を呼び出す必要があります。
CListBox オブジェクトのメモリを割り当てた場合、割り当てを破棄するに CListBox のデストラクターをオーバーライドします。
継承階層
CListBox
必要条件
ヘッダー: afxwin.h