AutoSearch プロパティ (ComboBoxCellType)

文字キーの入力によってコンボボックスの項目リストを検索する方法を取得または設定します。

構文

Visual Basic
C#

'Declaration
 
Public Property AutoSearch As AutoSearch

public AutoSearch AutoSearch {get; set;}

プロパティ値

リスト項目の検索方法を決定するAutoSearch設定

解説

このプロパティを使用すると、ユーザーは１つまたは複数の文字を入力してコンボボックスのリストの項目までスクロールできます。

このプロパティを設定した場合、コントロールは検索設定に基づいてドロップダウンリスト内の項目を自動的に検索し、ユーザー入力に一致する項目を見つけます。たとえば、１つの文字に設定した場合、ユーザーが入力する最初の文字に基づいて項目を検索します。一致する項目が見つかると、その項目までスクロールして、その値をセルに入れます。このプロパティに設定可能な値については、FarPoint.Win.AutoSearch列挙体を参照してください。１文字を入力すると、その文字で始まる最初の項目の検索が開始されます。見つかった項目がリストの画面に表示されていない場合、コントロールはその文字または文字列に一致する最初の項目までスクロールします。見つかった項目はハイライト表示されます。

検索では大文字と小文字は区別されません。

検索文字が見つからず、設定がSingleCharacterの場合、どの項目もハイライト表示されません。

設定がMultipleCharacterの場合、複数の文字が入力されると、最も近い位置にある検索文字列の一致項目にハイライト表示が移動します（たとえば、「var」と入力すると"Variegated"がハイライト表示されます）。入力された最初の文字で始まる項目がない場合、リストはスクロールされません。

設定がSingleGreaterThanの場合、検索文字が見つからなければ、次に大きい項目がハイライト表示されます。たとえば、ユーザーが"f"文字を検索したときに"f"で始まる項目がない場合、"g"の文字で始まる最初の項目がハイライト表示されます。一致する項目が見つかった場合、キーを繰り返し入力すると、すべての一致項目の間を循環します。

たとえば、コントロールが５つの行を表示し、このプロパティをMultipleCharacterに設定したと仮定します。リスト項目"Willow Springs"は10行目にあり、"Wilmington"は20行目にあります。「w」文字を入力すると、リストは"Willow Springs"までスクロールします。次に、文字を「i」、「l」の順に入力しても何も変わりません。４番目に「m」を入力すると、リストは"Wilmington"までスクロールします。４番目に「z」（一致項目がない）を入力すると、リストはスクロールして最初の行がリストの先頭行になります。

例

次のサンプルコードは、１月から６月までを含むコンボボックスを最初のシートのセルに設定し、表示部分のサイズを指定します。

C#
Visual Basic

FarPoint.Win.Spread.CellType.ComboBoxCellType cmbocell = new FarPoint.Win.Spread.CellType.ComboBoxCellType();
cmbocell.Items = (new String[] {"January", "February", "March", "April", "May", "June"});
cmbocell.AcceptsArrowKeys = FarPoint.Win.SuperEdit.AcceptsArrowKeys.AllArrows;
cmbocell.AutoSearch = FarPoint.Win.AutoSearch.SingleCharacter;
cmbocell.Editable = true;
cmbocell.ListAlignment = FarPoint.Win.ListAlignment.Left;
cmbocell.ListOffset = 20;
cmbocell.ListWidth = 0;
cmbocell.MaxDrop = 4;
fpSpread1.Sheets[1].Cells[2,2].CellType = cmbocell;

Dim cmbocell As New FarPoint.Win.Spread.CellType.ComboBoxCellType()
cmbocell.Items = (new String() {"January", "February", "March", "April", "May", "June"})
cmbocell.AcceptsArrowKeys = FarPoint.Win.SuperEdit.AcceptsArrowKeys.AllArrows
cmbocell.AutoSearch = FarPoint.Win.AutoSearch.SingleCharacter
cmbocell.Editable = True
cmbocell.ListAlignment = FarPoint.Win.ListAlignment.Left
cmbocell.ListOffset = 20
cmbocell.ListWidth = 0
cmbocell.MaxDrop = 4
fpSpread1.Sheets(1).Cells(2,2).CellType = cmbocell

参照

ComboBoxCellType クラス
 ComboBoxCellType メンバ
 Editable プロパティ

開発者ガイド

コンボボックス型セル