このチュートリアルでは、 ValueItems オブジェクトとValueItemオブジェクトのコレクションの使用方法を学びます。コードを１行も記述しないで、セルにビットマップやチェックボックスを表示します。
以下の手順を実行します。
- チュートリアル7: 組み込みコンボを使って変換データを表示する で使用したプロジェクトから始めます。
- Visual Studio のプロパティウィンドウで、Columns プロパティの横にある省略符ボタンをクリックします。C1TrueDBGrid デザイナが表示されます。
- How列を選択し、C1TrueDBGrid デザイナの左ペインで Caption プロパティを方法に設定します。同様に、連絡済み列の Caption プロパティを連絡？に設定します。
- この２つの列のHorizontalAlignment プロパティを、ビットマップが各セルの中央に配置されるように変更します。Visual Studio のプロパティウィンドウで、Splits プロパティの横にある省略符ボタンをクリックして、SplitCollection エディタを開きます。次に、このエディタで、DisplayColumn プロパティの横にある省略符ボタンをクリックして、C1DisplayColumnCollection エディタを開きます。左ペインで方法列を選択し、右ペインで Styles プロパティの横にある展開アイコンをクリックします。この列の Styles オブジェクトの下で、HorizontalAlignment プロパティを Center に設定します。同様に、連絡？列の HorizontalAlignment プロパティを設定します。
- 次に、選択した列にビットマップとチェックボックスを割り当てるために、対応する ValueItems オブジェクトにデータを挿入します。列1のビットマップから始めます。 Visual Studio のプロパティウィンドウで、Columns プロパティの横にある省略符ボタンをクリックして、C1TrueDBGrid デザイナを開きます。左ペインで「方法」列を選択し、右ペインで Value item オブジェクトの横にある展開アイコンをクリックします。Values プロパティの横にある省略符ボタンをクリックして、ValueItemsエディタを開きます。
- 左ペインの〈追加〉ボタンをクリックして、新しい ValueItem オブジェクトを３つ作成します。ContactTypeフィールドの有効な値は、０，１ と ２ で、それぞれ電話、メール、担当者を表します。これらの値の代わりにビットマップをセルに表示します。本製品の内容をすべてインストールしている場合は、True DBGrid for WinForms のインストールディレクトリの Tutorial10 サブディレクトリに、PHONE.BMP, MAIL.BMP, と PERSON.BMPM.BMP があります
- 右ペインで、最初の ValueItem の値として0を入力し、DisplayValue プロパティボックスの省略符ボタンをクリックします。これにより、セルに表示する画像ファイルを検索できます。True DBGrid for WinForms のインストールディレクトリの Tutorial10 サブディレクトリにある Phone.bmp ファイルを見つけます。同様に、もう一つの ValueItem オブジェクトを設定します。Value を １ に、DisplayValue を Person.bmp に設定します。C1TrueDBGrid デザイナの ValueItems オブジェクトに戻り、Translate プロパティと CycleOnClick プロパティを True に設定します。
- 次に、列３のチェックボックスを設定します。C1TrueDBGrid デザイナの左ペインで、連絡済列を選択します。右ペインで、ValueItems オブジェクトを展開し、Presentation プロパティを CheckBox に設定します。これにより、列のブール値がチェックボックスとして表示されます。最後に、同じオブジェクトの下で、Translate プロパティと CycleOnClick プロパティを True に設定します。
プログラムを実行し、次の動作を確認します。
- C1TrueDBGrid1 には、前のチュートリアルと同様に、結合されたテーブルのデータが表示されます。
- 次の図のように、方法列と連絡？列には、数値ではなくビットマップが表示されます。
- 方法列のセルをクリックして、現在のセルにします。さらにセルを何回かクリックして、電話、メールと人を表す各ビットマップが順番に表示されるようすを確認します。
- 連絡？列のセルをクリックして、チェックボックスのビットマップが切り替わるようすを確認します。
これでチュートリアル 10 は終了です。