ROWLIST サンプル : リスト ビューの全行選択
更新 : 2007 年 11 月
ROWLIST サンプルでは、MFC コモン コントロール クラス CListView のレポート モードでの全行選択の方法を示します。このサンプルでは、再利用可能な CListViewEx クラスを実装しているため、リスト ビュー コントロールの追加ビュー モードとして全行を選択できます。CListViewEx は、オーナー描画モードを使用して、コントロールに対するすべての描画を実行します。独自のプロジェクトでは、このクラスを直接使用したり、または基本クラスとして使用したりできます。ROWLIST では、リスト ビュー コントロールで状態イメージとオーバーレイ イメージを使用する方法も示します。
セキュリティに関するメモ : |
---|
このサンプル コードは概念を示す目的で提供されているものです。必ずしも最も安全なコーディング手法に従っているわけではないので、アプリケーションまたは Web サイトでは使用しないでください。Microsoft は、サンプル コードが意図しない目的で使用された場合に、付随的または間接的な損害について責任を負いません。 |
サンプルとそのインストール手順を取得するには
Visual Studio で、[ヘルプ] メニューの [サンプル] をクリックします。
詳細については、「サンプル ファイルの格納場所」を参照してください。
使用できるサンプルの最新バージョンと完全な一覧については、オンラインの Visual Studio 2008 Samples のページを参照してください。
サンプルは、コンピュータのハード ディスク上にもあります。既定では、サンプルおよび Readme ファイルは、\Program Files\Visual Studio 9.0\Samples\ の下のフォルダにコピーされます。Visual Studio Express Edition の場合、すべてのサンプルはオンライン上にあります。
サンプルのビルドと実行
ROWLIST サンプルをビルドおよび実行するには
ソリューション rowlist.sln を開きます。
[ビルド] メニューの [ビルド] をクリックします。
[デバッグ] メニューの [デバッグなしで開始] をクリックします。
ROWLIST を実行すると、CListView の派生クラスのビューを持つ、シングル ドキュメント インターフェイス (SDI: Single-Document Interface) アプリケーションが起動します。このビューの各項目は、各種の色を表しており、それぞれの項目についての追加データも表示されます。初期状態のリスト ビュー コントロールは、全行選択が有効なレポート モードで表示されます。[View] メニューとツール バーを使用すると、他のビュー モードを選択できます。
初期状態の状態イメージとして、各項目の左側に空の四角形が表示されます。状態イメージをクリックすると、その項目のイメージは、キャプション バーに表示されるアイコンになります。状態イメージが表示されない場合は、項目をダブルクリックすると状態が変わります。
CListViewEx クラス
CListViewEx クラスは、CListView から派生した全行選択モードを実装する再利用可能なクラスです。このクラスでは、リスト ビュー コントロールのオーナー描画モードを全面的にサポートしています。このため、すべてのイメージとラベルを描画するコードを実装することによって、全行選択機能を提供しています。CListViewEx では、全行選択機能に加えて、コントロールのイメージとラベルをレポート モードと同じように表示できます。このクラスには、CListView と比較して、ほかに 2 つのメンバ関数 SetFullRowSel と GetFullRowSel があるだけです。これらの関数では、全行選択モードを設定または照会します。
このクラスを独自のプロジェクトで再利用するには、このクラスから別のクラスを派生するか、または直接このクラスを使用します。このクラスを使用する最も簡単な方法は、アプリケーション ウィザードで CListView の派生クラスを持つアプリケーションを作成し、基本クラスを CListViewEx に変更することです。
CListView での状態イメージとオーバーレイ イメージの使用
ROWLIST では、状態イメージとオーバーレイ イメージを使用する例を示します。初期状態の状態イメージとして、各項目の左側に空の四角形が表示されます。状態イメージをクリックすると、その項目のイメージは、キャプション バーに表示されるアイコンになります。これに応じて、項目の状態アイコンはチェック マークが付いた四角形に変わります。CRowListView::OnLButtonDown には、状態アイコンが選択された場合に、チェック マークを挿入し、項目の状態アイコンを変更するコードが含まれています。
状態イメージが表示されない場合は、現在使用中のイメージの上にオーバーレイ イメージがマークされます (チェック マークが付いた淡色表示の四角形)。ダブルクリックすると、項目の状態を変更できます。これにより、オーバーレイ イメージのオンとオフも切り替わります。ダブルクリックの実装コードは CRowListView::OnLButtonDblClk にあります。
メモ : |
---|
このサンプルを含む一部のサンプルには、Visual C++ のウィザード、ライブラリ、およびコンパイラの変更が反映されていませんが、必要なタスクを実行する方法は示されています。 |