TextBox.AutoCompleteMode プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
TextBox のオート コンプリートの動作を制御するオプションを取得または設定します。
public:
property System::Windows::Forms::AutoCompleteMode AutoCompleteMode { System::Windows::Forms::AutoCompleteMode get(); void set(System::Windows::Forms::AutoCompleteMode value); };[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.AutoCompleteMode AutoCompleteMode { get; set; }[<System.ComponentModel.Browsable(true)>]
member this.AutoCompleteMode : System.Windows.Forms.AutoCompleteMode with get, setPublic Property AutoCompleteMode As AutoCompleteModeプロパティ値
AutoCompleteMode の値の 1 つです。 値は次のとおりです。
Append
既存の文字に、その後に続く可能性が最も高い候補文字列を追加し、追加した文字を強調表示します。
Suggest
エディット コントロールに関連付けられた補助のドロップダウン リストを表示します。 このドロップダウン リストには、1 つ以上の補完文字列の候補が格納されています。
SuggestAppend
Suggest オプションと Append オプションの両方を追加します。
None
オートコンプリートを無効にします。 これは既定値です。
- 属性
例外
指定された値が AutoCompleteMode の値の 1 つではありません。
例
次のコード例は、コントロールのオートコンプリート カスタム ソースとしてコレクションを使用する方法を TextBox 示しています。 この例の内容は次のとおりです。
このプロパティを AutoCompleteSource 使用して、コントロールが TextBox オートコンプリート動作のカスタム ソースを受け入れるようにします。
プロパティを AutoCompleteCustomSource 使用して、値のカスタム リストを設定します。
このプロパティを AutoCompleteMode 使用して、オートコンプリート候補の表示方法を設定します。
private void Form1_Load(object sender, EventArgs e)
{
// Create the list to use as the custom source.
var source = new AutoCompleteStringCollection();
source.AddRange(new string[]
{
"January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December"
});
// Create and initialize the text box.
var textBox = new TextBox
{
AutoCompleteCustomSource = source,
AutoCompleteMode =
AutoCompleteMode.SuggestAppend,
AutoCompleteSource =
AutoCompleteSource.CustomSource,
Location = new Point(20, 20),
Width = ClientRectangle.Width - 40,
Visible = true
};
// Add the text box to the form.
Controls.Add(textBox);
}
Private Sub Form1_Load(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles MyBase.Load
' Create the list to use as the custom source.
Dim MySource As New AutoCompleteStringCollection()
MySource.AddRange(New String() _
{ _
"January", _
"February", _
"March", _
"April", _
"May", _
"June", _
"July", _
"August", _
"September", _
"October", _
"November", _
"December" _
})
' Create and initialize the text box.
Dim MyTextBox As New TextBox()
With MyTextBox
.AutoCompleteCustomSource = MySource
.AutoCompleteMode = AutoCompleteMode.SuggestAppend
.AutoCompleteSource = AutoCompleteSource.CustomSource
.Location = New Point(20, 20)
.Width = Me.ClientRectangle.Width - 40
.Visible = True
End With
' Add the text box to the form.
Me.Controls.Add(MyTextBox)
End Sub
注釈
プロパティをAutoCompleteCustomSourceAutoCompleteMode使用して、入力されているプレフィックスとAutoCompleteSource保守されているソース内のすべての文字列のプレフィックスを比較することで、入力文字列を自動的に完了する文字列を作成TextBoxします。 これは、URL、アドレス、ファイル名、またはコマンドを頻繁に入力するコントロールに役立ちます TextBox 。
プロパティのAutoCompleteCustomSource使用は省略可能ですが、使用するにはプロパティをAutoCompleteSource設定するCustomSourceAutoCompleteCustomSource必要があります。
プロパティとプロパティAutoCompleteSourceを一緒にAutoCompleteMode使用する必要があります。
注意
オペレーティング システムでは、一度に表示できるカスタム文字列の数が制限される場合があります。