バージョン

AutoCompleteMode プロパティ (UltraGridColumn)

編集部分で入力されたテキストのオート コンプリート モードを取得または設定します。
シンタックス
'宣言
 
Public Property AutoCompleteMode As Infragistics.Win.AutoCompleteMode
public Infragistics.Win.AutoCompleteMode AutoCompleteMode {get; set;}
解説

注: このプロパティは現在廃止されている AutoEdit プロパティを置き換えます。AutoCompleteMode プロパティを 'Append' に設定することは AutoEdit を True に設定することと機能的に等しいです。

AutoCompleteMode プロパティが追加される前は、値の自動補完は現在廃止されている AutoComplete プロパティの形式でサポートされていました。入力した文字でテキストが始まるリストで見つかった最初の項目のテキストに一致するように、このプロパティが有効の時には、エンドユーザーによって入力された文字列に文字を追加することによってコントロールのテキストを修正しました。たとえば、テキストが "Apple" の項目を含むリストがあり、エンドユーザーが文字列 "Ap" を入力すると編集部分は更新されて残りの文字列 "ple" を含みます。これによって入力した文字列に一致する最初の項目のテキスト "Apple" が選択された状態になります。AutoCompleteMode を 'Append' に設定することによって同じ機能が有効になっています。入力を続行することによってこれらの文字が削除されるように追加された文字が選択されます。

AutoCompleteMode プロパティは、値補完のための 2 つの追加モード、'Suggest' と 'SuggestAppend' を拡張します。プロパティが 'Suggest' に設定されると、編集部分に文字は一切追加されず、ドロップダウンが自動的に表示されて、エンドユーザーが入力した文字列でテキストが始まる項目のみを示します。たとえば、"Apple"、"Application" および "Apprehend" を含むリストが提供されており、文字 "A" を入力すると、ドロップダウン リストが表示され、すべてのこれらの項目を示します。さらに文字を入力するとリストは継続してフィルターされ、テキストが入力された文字列と一致しないエントリを排除します。たとえば、入力を続行して編集部分に "Appl" が含まれると、"Apprehend" 項目はリストから削除されます。入力された文字列に文字 "l" があることによりその項目が排除されるからです。

'SuggestAppend' 設定は基本的に 'Append' と 'Suggest' の設定によって拡張された機能を結合します。ドロップダウン リストが自動的に表示され、必要に応じてフィルタリングされます。テキストが編集部分に追加され最初の項目に一致する入力されたテキストを一致するテキストで補完します。

ValueList プロパティを設定すると、特定の環境で suggest モードの機能を妨げる場合があります。たとえば、プロパティが UltraDropDown コントロールへの参照に設定される場合、suggest モードは無効になります。複数列リストに対する Suggest モードのサポートは、UltraCombo コントロールによって拡張されます。UltraCombo コントロールへの参照を列の EditorControl プロパティに指定し(これにより UltraCombo は、その IProvidesEmbeddableEditor 実装を介して UltraGridComboEditor インスタンスの機能を果たす)、次に列またはコントロールのいずれかで AutoCompleteMode プロパティを設定することによって、これは有効にできます。

ValueList インスタンスが ValueList プロパティに指定され、Editor プロパティがデフォルト値のままの時、または Infragistics.Win.EditorWithCombo クラスのインスタンスを参照する時、suggest モードは完全にサポートされます。

参照