コンボボックス型セル

コンボボックス型セルを使用すると、編集可能なドロップダウンリストを表示できます。リストに表示された値の選択だけでなく、値の入力をユーザーに許可できます。ユーザーに編集を許可するか、リスト内の項目にテキストとともにアイコンを表示するか、常に表示する項目数を指定できます。

テキストのみのリストボックス	テキストとアイコンによるリストボックス

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

コンボボックス外観のカスタマイズ

コンボボックス型セルの外観に関する設定には、以下のプロパティを使用します。

プロパティ	説明
BackgroundImage	コンボボックスの編集可能な部分に対し、背景に表示するイメージを設定します。
ButtonAlign	ボタンの配置を設定します。
ImageList	コンボボックスのドロップダウンリストに、テキストとともにアイコンを表示する場合の画像リストを設定します。
ItemData	コンボボックスのドロップダウンリストに使用する項目のデータを設定します。これは、実際に表示される項目とは異なります。
Items	コンボボックスのドロップダウンリストに使用する各項目を設定します。
ListAlignment	リストをセルのどの部分に揃えて配置するかを設定します。
ListOffset	リストを揃えたセルの端からリストまでの距離を、ピクセル単位で定義します。
ListWidth	ドロップダウンリストの幅をピクセル単位で設定します。
MaxDrop	リスト部分に一度に表示される項目数を設定します。表示項目より多くの項目が存在する場合は、垂直スクロールバーが表示されます。
MaxLength	コンボボックス型セルに表示可能な最大文字数を設定します。

コンボボックス操作のカスタマイズ

コンボボックス型セルの操作に関する設定には、以下のプロパティを使用します。

プロパティ	説明
AcceptsArrowKeys	コンボボックスコントロールによって矢印キーが処理される方法を設定します。
AutoSearch	文字キーの入力に応じて、コンボボックスの項目リストが検索される方法を定義します。
CharacterCasing	テキストセルに使用する文字を大文字にするか、または小文字にするかを設定します。
CharacterSet	テキストセルで有効となる文字の種類を設定します。
Editable	コンボボックスの編集領域への入力を可能にするかどうかを設定します。
EditorValue	下層のデータモデルに書き込まれるデータの種類を定義します。
ListControl	SPREADの組み込みリストコントロールを使用しない場合に、リスト部分に使用するコントロールを設定します。

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

オートコンプリートのカスタマイズ

以下のプロパティを使用して、コンボボックス型セルのオートコンプリート機能をカスタマイズできます。

プロパティ	説明
AutoCompleteCustomSource	コンボボックス内のエントリに対するオートコンプリートのカスタムソース（文字列）を設定します。
AutoCompleteMode	コンボボックス内のエントリに対するオートコンプリートのモードを設定します。
AutoCompleteSource	コンボボックス内のエントリに対するオートコンプリートのソースを設定します。

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

設定方法

ComboBoxCellTypeクラスのインスタンスを作成して、クラスの各プロパティを設定します。コンボボックスのリストに項目を表示するには、

Itemsプロパティを使用するか、クラスのインスタンス作成時に、コンストラクタの引数として設定する方法があります。MaxDropプロパティを使用すると、リストに一度で表示する項目の最大数を設定できます。設定した数以上の項目が存在する場合、リストにスクロールバーが表示れます。

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

サンプルコード

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

FarPoint.Win.Spread.CellType.ComboBoxCellType cmbocell = new FarPoint.Win.Spread.CellType.ComboBoxCellType();
cmbocell.Items = (new String[] {"January", "February", "March", "April", "May", "June"});
cmbocell.AutoSearch = FarPoint.Win.AutoSearch.SingleCharacter;
cmbocell.Editable = true;
cmbocell.MaxDrop = 4;
fpSpread1.ActiveSheet.Cells[0, 0].CellType = cmbocell;

Dim cbstr As string( )
cbstr = new String() {"Jan", "Feb", "Mar", "Apr", "May", "Jun"}
Dim cmbocell As New FarPoint.Win.Spread.CellType.ComboBoxCellType()
cmbocell.Items = cbstr
cmbocell.AutoSearch = FarPoint.Win.AutoSearch.SingleCharacter
cmbocell.Editable = True
cmbocell.MaxDrop = 4
FpSpread1.ActiveSheet.Cells(0, 0).CellType = cmbocell

SPREAD デザイナの使用

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

参照