オートコンプリート機能を利用すると入力文字列を自動的に補完することが可能です。URL、住所、ファイル名、コマンドなどを頻繁に入力する場合に特に有効です。
オートコンプリート機能の設定
AutoCompleteSource、AutoCompleteMode、AutoCompleteCustomSourceの各プロパティを利用して、オートコンプリート機能を利用することが可能です。オートコンプリート機能は入力された文字を管理されたソース内のすべての文字列を検索して入力文字列を自動的に補完します。URL、住所、ファイル名、コマンドなどを頻繁に入力する場合に特に有効です。
 |
注意 検索モードの設定で AutoCompleteMatchingMode プロパティと AutoCompleteMode プロパティの組み合わせがサポートされない組み合わせの場合、InputManCell では例外が発生します。 |
オートコンプリートウィンドウのスタイル
AutoCompleteクラスを利用すると、オートコンプリート機能で表示されるリストのスタイルを設定することが可能です。
- CandidateListItemFont（補完文字列の候補リスト内のフォントを設定します。）
- HighlightMatchedText（補完文字列の候補リスト内の検索文字列をハイライト表示するかどうかを設定します。）
- HighlightStyle（ハイライト表示される検索文字列のスタイルを設定します。）
(図) 候補リスト内のフォントと検索文字列のハイライトを設定したCalendarGcTextBoxCellType
検索モードの設定
AutoCompleteクラスには、オートコンプリート機能で利用する検索モードを設定するMatchingModeプロパティがあり、6種類の検索方法から選択することが可能です。
| MatchingModeの値 | 説明 |
|---|---|
|
MatchStartWith |
前方一致 大文字／小文字の区別なし 全角／半角／ひらがな／カタカナ／ｶﾀｶﾅの区別あり で検索します。 |
|
MatchAll |
部分一致 大文字／小文字の区別なし 全角／半角／ひらがな／カタカナ／ｶﾀｶﾅの区別あり で検索します。 |
|
AmbiguousMatchStartWith |
前方一致 大文字／小文字の区別なし 全角／半角／ひらがな／カタカナ／ｶﾀｶﾅの区別なし で検索します。 |
|
AmbiguousMatchAll |
部分一致 大文字／小文字の区別なし 全角／半角／ひらがな／カタカナ／ｶﾀｶﾅの区別なし で検索します。 |
|
ExactMatchStartWith |
前方一致 大文字／小文字の区別あり 全角／半角／ひらがな／カタカナ／ｶﾀｶﾅの区別あり で検索します。 |
|
ExactMatchAll |
部分一致 大文字／小文字の区別あり 全角／半角／ひらがな／カタカナ／ｶﾀｶﾅの区別あり で検索します。 |
|
注意 AutoCompleteMatchingMode プロパティのうち、部分一致を行うMatchAll、AmbiguousMatchAll、およびExactMatchAll はAutoCompleteMode プロパティがSuggestAppend、Append のときにはサポートされません。
|
検索モードの実行例
それぞれの検索モードを実行した場合の結果例は下記のようになります。
| 候補リスト | MatchStartWith | MatchAll |
|---|---|---|
 |
前方一致 |
部分一致 |
   |
   | |
| AmbiguousMatchStartWith | AmbiguousMatchAll | |
|
前方一致 |
部分一致 | |
   |
   | |
| ExactMatchStartWith | ExactMatchAll | |
|
前方一致 |
部分一致 | |
  |
  |
|
注意 候補リスト内に同じ候補が存在した場合には、あとの候補が検索対象になります。 |