カラムの設定

リストボックスを複数列で表示し各項目にサブ項目を設定するには、リストボックスにカラムを追加する必要があります。ここでは、カラムについて解説します。

カラムの追加

リストコントロールを複数列で表示し、各項目にサブ項目を設定するには、コントロールにカラムを追加します。表示できるカラム数には制限はありません。カラムを追加するには、スマートタグの「カラムの編集...」または、プロパティウィンドウのColumnsプロパティから開かれる「ListColumn コレクションエディタ」でカラムを設定し〈追加〉ボタンをクリックします。

カラムをコードで追加するには、ListColumnオブジェクトを生成し、コントロールのColumnsプロパティが参照するコレクションに追加します。ListColumnクラスは、列全体のスタイルや表示するデータの種類を設定することができます。

また、カラムのインデックスを下記のプロパティに設定することで、それぞれの目的でサブ項目を使用できます。

TextSubItemIndexプロパティ（サブ項目の内容をコントロールのTextプロパティとして使用するカラムのインデックス）
DescriptionSubItemIndexプロパティ（サブ項目の内容をステータスバーに表示するカラムのインデックス）
SortColumnIndexプロパティ（項目のソートに使用するカラムのインデックス）

次のサンプルコードでは、コントロールにカラムを追加する方法を示します。

Visual Basic
C#

Imports GrapeCity.Web.Input.Core.ListBox

' カラムを作成します。
Dim lc1 As New ListColumn()
Dim lc2 As New ListColumn()
Dim lc3 As New ListColumn()

' コンボコントロールにカラムを追加します。
GcListBox1.Columns.Add(lc1)
GcListBox1.Columns.Add(lc2)
GcListBox1.Columns.Add(lc3)

using GrapeCity.Web.Input.Core.ListBox;

// カラムを作成します。
ListColumn lc1 = new ListColumn();
ListColumn lc2 = new ListColumn();
ListColumn lc3 = new ListColumn();

// コンボコントロールにカラムを追加します。
GcListBox1.Columns.Add(lc1);
GcListBox1.Columns.Add(lc2);
GcListBox1.Columns.Add(lc3);

カラムの既定値

コントロールのDefaultColumnプロパティが参照するDefaultListColumnオブジェクトを使用すると、追加したカラムに既定値を設定することができます。カラムの既定値の設定は、データソース接続をするとき、AutoGenerateColumnsプロパティがTrueで、自動的にカラムを追加する場合などに便利な機能です。

次のサンプルコードでは、カラムの既定値を設定します。

Visual Basic
C#

GcListBox1.DefaultColumn.AutoWidth = True
GcListBox1.DefaultColumn.Header.AllowResize = True
GcListBox1.DefaultColumn.Header.Clickable = True

GcListBox1.DefaultColumn.AutoWidth = true;
GcListBox1.DefaultColumn.Header.AllowResize = true;
GcListBox1.DefaultColumn.Header.Clickable = true;

カラムの削除

リストボックスからカラムを削除するには、スマートタグの「カラムの編集...」または、プロパティウィンドウのListBox.Columnsプロパティから開かれる「ListColumn コレクションエディタ」で、削除したいカラムを選択して〈削除〉ボタンをクリックします。
コードからカラムを削除するには、Columnsプロパティが参照するコレクションからRemoveメソッドまたはRemoveAtメソッドを使用します。

次のサンプルコードは、RemoveAtメソッドを使用してカラムを削除する例です。

Visual Basic
C#

GcListBox1.Columns.RemoveAt(0)

GcListBox1.Columns.RemoveAt(0);