マルチカラムコンボボックス型セル

複数列のドロップダウンリストを表示するコンボボックス型セルを作成できます。リストに表示された値の選択だけでなく、値の入力をユーザーに許可できます。リスト内の項目、常に表示する項目数を指定できます。

マルチカラムコンボボックス型セル

マルチカラムコンボボックス型セルとその各属性を設定するには、MultiColumnComboBoxCellTypeクラスを使用します。

マルチカラムコンボボックス外観のカスタマイズ

マルチカラムコンボボックス型セルの表示をカスタマイズするには、以下のプロパティを使用します。

プロパティ	カスタマイズ
BackgroundImage	セルの背景画像を設定します。
ButtonAlign	ボタンを表示する位置を設定します。
ColumnEdit	リスト内で編集領域として使用される列を設定します。
DataColumn	リスト内でデータ列として使用する列を設定します。
DataSourceList	セルのリスト部分に使用するデータソースを設定します。
ListAlignment	エディタのどの部分にリストを揃えて表示するかを設定します。
ListOffset	エディタからのリストのオフセットを設定します。
ListWidth	リストの幅を設定します。
MaxDrop	リスト内に一度に表示される最大項目数を設定します。
StringTrim	セル幅に収まらない文字を切り取る方法を設定します。
SubEditor	サブエディタを設定します。

マルチカラムコンボボックス操作のカスタマイズ

マルチカラムコンボボックス型セルの操作をカスタマイズするには、以下のプロパティを使用します。

プロパティ	操作
AcceptsArrowKeys	セルによって矢印キーが処理される方法を設定します。
AutoSearch	文字キーの入力に応じて、コンボボックス型セルのリスト項目が検索される方法を設定します。
DataColumn	リスト内でデータ列として使用する列を設定します。
DataSourceList	セルのリスト部分に使用するデータソースを設定します。
Editable	セルの編集可能領域へのユーザーの入力を許可します。

MultiColumnComboBoxCellTypeクラスが持つプロパティのほか、FpSpreadクラスのButtonDrawModeプロパティが、マルチカラムコンボボックスの動作に影響を与えます。このプロパティは、コマンドボタン型セル、およびコンボボックス型セルでも有効です。ドロップダウンボタンを常時表示するのか、または現在の行、列、およびセル内でのみ表示するのかを設定できます。

!type=note
メモ：
特定のセル型において、一部のグラフィカル要素がビジュアルスタイルの影響を受けることに注意してください。 FpSpreadクラスのVisualStylesプロパティを「Off」に設定すると、これらのグラフィカルなセル型の視覚的なカスタマイズを、指定したとおりに機能させることができます。詳細については、「ビジュアルスタイル」を参照してください。
1つの列から成る、標準コンボボックス型セルの詳細については、「コンボボックス型セル」を参照してください。

設定方法

MultiColumnComboBoxCellTypeクラスのインスタンスを作成して、クラスの各プロパティを設定します。マルチカラムコンボボックスのリストに項目を表示するには、DataSourceListプロパティにリストのデータソースを設定します。DataColumnプロパティに、セルの値として使用するデータソースの列をインデックスで設定します。ColumnEditプロパティに、セルに表示する（編集を許可する場合は、編集の対象となる）データソースの列をインデックスで設定します。列をインデックスではなく名前で指定する場合は、DataColumnNameおよびColumnEditNameプロパティを使用します。MaxDropプロパティを使用すると、リストに一度で表示する項目の最大数を設定できます。設定した数以上の項目が存在する場合、リストにスクロールバーが表示れます。

セルに設定する場合はCellクラスの、行に設定する場合はRowクラスの、列に設定する場合はColumnクラスの、あるいはスタイルに設定する場合はStyleInfoクラスのCellTypeプロパティに、定義したMultiColumnComboBoxCellTypeクラスのインスタンスを割り当てます。

サンプルコード

次のサンプルコードは、セルをマルチカラムコンボボックス型セルに設定します。

string conStr = "Provider=Microsoft.JET.OLEDB.4.0;data source=C:\\AccessData\\Patients2000.mdb";
string sqlStr = "SELECT * FROM Patients";
System.Data.OleDb.OleDbConnection conn = new System.Data.OleDb.OleDbConnection(conStr);
DataSet ds = new DataSet();
System.Data.OleDb.OleDbDataAdapter da = new System.Data.OleDb.OleDbDataAdapter(sqlStr, conn);
da.Fill(ds);
FarPoint.Win.Spread.CellType.MultiColumnComboBoxCellType mcb = new FarPoint.Win.Spread.CellType.MultiColumnComboBoxCellType();
mcb.DataSourceList = ds;
mcb.DataColumn = 2;
mcb.ColumnEdit = 2;
mcb.ButtonAlign = FarPoint.Win.ButtonAlign.Left;
mcb.ListAlignment = FarPoint.Win.ListAlignment.Right;
mcb.ListWidth = 500;
mcb.ListOffset = 5;
mcb.MaxDrop = 5;
fpSpread1.ActiveSheet.Cells[0, 0].CellType = mcb;

Dim conStr As String = "Provider=Microsoft.JET.OLEDB.4.0;data source=C:\AccessData\Patients2000.mdb"
Dim sqlStr As String = "SELECT * FROM Patients"
Dim conn As New System.Data.OleDb.OleDbConnection(conStr)
Dim ds As DataSet = New DataSet()
Dim da As New System.Data.OleDb.OleDbDataAdapter(sqlStr, conn)
da.Fill(ds)
Dim mcb As New FarPoint.Win.Spread.CellType.MultiColumnComboBoxCellType()
mcb.DataSourceList = ds
mcb.DataColumn = 1
mcb.ButtonAlign = FarPoint.Win.ButtonAlign.Left
mcb.ListWidth = 500
mcb.ListOffset = 5
mcb.MaxDrop = 5
FpSpread1.ActiveSheet.Cells(0, 0).CellType = mcb

SPREAD デザイナの使用

作業領域内のセルまたはセル範囲を選択します。
プロパティリストの「その他」カテゴリから、CellType プロパティを選択します。ドロップダウンリストからコンボボックス型を選択します。これによって CellType プロパティが展開され、このセル型に固有のさまざまなプロパティが表示されます。このリストから、必要に応じてプロパティを選択および設定します。
または、セルまたはセル範囲を右クリックして［セル型］を選択します。セル型の一覧からコンボボックス型を選択します。セル型エディタで、必要なプロパティを設定します。〈適用〉ボタンをクリックします。
［ファイル］メニューから［適用して終了］を選択し、変更をコンポーネントに適用して SPREAD デザイナを終了します。

参照