TextBox.AutoCompleteMode プロパティ

定義

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, set
Public Property AutoCompleteMode As AutoCompleteMode

プロパティ値

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使用する必要があります。

注意

オペレーティング システムでは、一度に表示できるカスタム文字列の数が制限される場合があります。

適用対象

こちらもご覧ください