[]
オートコンプリート機能を利用すると入力文字列を自動的に補完することが可能です。URL、住所、ファイル名、コマンドなどを頻繁に入力する場合に特に有効です。
AutoCompleteSource プロパティ、AutoCompleteMode プロパティ、AutoCompleteCustomSource プロパティ各プロパティを利用して、オートコンプリート機能を利用することが可能です。
AutoCompleteInfo クラスを利用すると、オートコンプリート機能で表示されるリストのスタイルを設定することが可能です。
CandidateListItemFont プロパティ(補完文字列の候補リスト内のフォントを設定します。)
HighlightMatchedText プロパティ(補完文字列の候補リスト内の検索文字列をハイライト表示するかどうかを設定します。)
HighlightStyle プロパティ(ハイライト表示される検索文字列のスタイルを設定します。)

AutoCompleteInfo クラスには、オートコンプリート機能で利用する検索モードを設定するMatchingMode プロパティがあり、6種類の検索方法から選択することが可能です。
MatchingModeの値 | 説明 |
|---|---|
MatchStartWith | 前方一致 大文字/小文字の区別なし 全角/半角/ひらがな/カタカナ/カタカナの区別あり で検索します |
MatchAll | 部分一致 大文字/小文字の区別なし 全角/半角/ひらがな/カタカナ/カタカナの区別あり で検索します |
AmbiguousMatchStartWith | 前方一致 大文字/小文字の区別なし 全角/半角/ひらがな/カタカナ/カタカナの区別なし で検索します |
AmbiguousMatchAll | 部分一致 大文字/小文字の区別なし 全角/半角/ひらがな/カタカナ/カタカナの区別なし で検索します |
ExactMatchStartWith | 前方一致 大文字/小文字の区別あり 全角/半角/ひらがな/カタカナ/カタカナの区別あり で検索します |
ExactMatchAll | 部分一致 大文字/小文字の区別あり 全角/半角/ひらがな/カタカナ/カタカナの区別あり で検索します |
!type=warning
注意:
AutoCompleteMatchingMode プロパティのうち、部分一致を行うMatchAll、AmbiguousMatchAll、およびExactMatchAll はAutoCompleteMode プロパティがSuggestAppend、Append のときにはサポートされません。
AutoCompleteMatchingMode プロパティとAutoCompleteMode プロパティの組み合わせがサポートされない組み合わせの場合、下記のような動作が行われます。
AutoCompleteMode プロパティが先に設定され、その後AutoCompleteMatchingMode プロパティが設定された場合AutoCompleteMode プロパティがNone に設定されます。
AutoCompleteMatchingMode プロパティが先に設定され、その後AutoCompleteMode プロパティが設定された場合例外が発生します。
それぞれの検索モードを実行した場合の結果例は下記のようになります。
候補リスト | MatchStartWith | MatchAll |
|---|---|---|
| 前方一致 大文字/小文字の区別なし 全角/半角/ひらがな/カタカナ/カタカナの区別あり | 部分一致 大文字/小文字の区別なし 全角/半角/ひらがな/カタカナ/カタカナの区別あり |
|
| |
AmbiguousMatchStartWith | AmbiguousMatchAll | |
前方一致 大文字/小文字の区別なし 全角/半角/ひらがな/カタカナ/カタカナの区別なし | 部分一致 大文字/小文字の区別なし 全角/半角/ひらがな/カタカナ/カタカナの区別なし | |
|
| |
ExactMatchStartWith | ExactMatchAll | |
前方一致 大文字/小文字の区別あり 全角/半角/ひらがな/カタカナ/カタカナの区別あり | 部分一致 大文字/小文字の区別あり 全角/半角/ひらがな/カタカナ/カタカナの区別あり | |
|
|
!type=warning
注意:候補リスト内に同じ候補が存在した場合には、あとの候補が検索対象になります。