CCheckListBox クラス
Windows のチェックリスト ボックスの機能を提供します。
class CCheckListBox : public CListBox
メンバー
パブリック コンストラクター
名前 |
説明 |
|---|---|
CCheckListBox オブジェクトを構築します。 |
パブリック メソッド
名前 |
説明 |
|---|---|
Windows のチェックリスト ボックスを作成し、CCheckListBox のオブジェクトにアタッチします。 |
|
オーナー描画リスト ボックスの外観が変更されたときに、フレームワークによって呼び出されます。 |
|
チェックリスト ボックスの項目を有効または無効にします。 |
|
項目のチェック ボックスの状態を取得します。 |
|
コントロールのチェック ボックスのスタイルを取得します。 |
|
項目が有効かどうかを判定します。 |
|
オーナー描画スタイルのリスト ボックスが作成されるときに、フレームワークによって呼び出されます。 |
|
項目のチェック ボックスの位置を取得するために、フレームワークによって呼び出されます。 |
|
項目のチェック ボックスの状態を設定します。 |
|
コントロールのチェック ボックスのスタイルを設定します。 |
解説
「チェックリスト ボックスは」ファイル名のような項目の一覧を表示します。 ユーザーがオンまたはオフにできるリストの各項目には、その横にチェック ボックスがあります。
CCheckListBox は、オーナー描画コントロールに対してのみリストを文字列詳細が含まれているためです。 簡単に言うと、チェックリスト ボックスは、チェック ボックスが含まれますが、テキストを持つまったく必要はありません。 たとえば、各項目の横にチェック ボックスがある小さいビットマップの一覧を持つことができます。
独自のチェックリスト ボックスを作成するには、CCheckListBoxから独自のクラスを派生させる必要があります。 独自のクラスを派生するには、派生クラスのコンストラクターと書き込み、**[作成]**を呼び出します。
親 (通常は CDialogの派生クラス) にリスト ボックスに送られた Windows の通知メッセージを処理するには、各メッセージの親クラスにメッセージ マップのエントリとメッセージ ハンドラー メンバー関数を追加します。
各メッセージ マップのエントリは次の形式を持ちます。
ON_通知(id、memberFxn)
id が送信するコントロールの子ウィンドウ ID を指定します。memberFxn は、通知と通知を処理する、記述された親メンバー関数の名前です。
親の関数のプロトタイプは次のようになります。
afx_msgvoidmemberFxn**( );**
CcheckListBox を厳密に参照する 1 台のメッセージ マップ エントリがあります (ただし CListBoxについては、メッセージ マップのエントリを参照) :
- ON_CLBN_CHKCHANGE ユーザーは項目のチェック ボックスの状態を変更。
自分のチェックリスト ボックスが既定のチェックリスト ボックス (それぞれの左側の既定サイズのチェック ボックスを持つ文字列の一覧) の場合、チェック リスト ボックスを描画して、既定 CCheckListBox::DrawItem を使用できます。 それ以外 CListBox::CompareItem 関数と CCheckListBox::DrawItem と CCheckListBox::MeasureItem 関数をオーバーライドする必要があります。
ダイアログ テンプレートから直接またはコードのチェックリスト ボックスを作成できます。
継承階層
CCheckListBox
必要条件
ヘッダー: afxwin.h