TextBox.AutoCompleteMode 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

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 값 중 하나입니다. 값은 다음과 같습니다.

Append
가장 가능성 있는 후보 문자열의 나머지를 기존 문자에 추가하고 추가된 문자를 강조 표시합니다.

Suggest
edit 컨트롤과 연결된 보조 드롭다운 목록을 표시합니다. 이 드롭다운 목록은 제시된 하나 이상의 완성 문자열로 채워집니다.

SuggestAppend
Suggest와 Append 옵션을 모두 추가합니다.

None
자동 완성을 사용하지 않습니다. 이것이 기본값입니다.

특성

BrowsableAttribute

예외

InvalidEnumArgumentException

지정한 값이 AutoCompleteMode의 값이 아닌 경우

예제

다음 코드 예제에서는 컨트롤에 대 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

설명

AutoCompleteCustomSource, AutoCompleteMode및 속성을 사용하여 입력되는 접두사와 AutoCompleteSource 유지 관리되는 원본의 모든 문자열 접두사에 비교하여 입력 문자열을 자동으로 완료하는 속성을 만듭니 TextBox 다. URL, 주소, 파일 이름 또는 명령을 자주 입력하는 컨트롤에 유용합니다 TextBox .

속성의 AutoCompleteCustomSource 사용은 선택 사항이지만 사용하려면 AutoCompleteCustomSource속성을 CustomSource 설정 AutoCompleteSource 해야 합니다.

속성과 AutoCompleteSource 속성을 함께 사용해야 AutoCompleteMode 합니다.

참고

운영 체제는 한 번에 표시할 수 있는 사용자 지정 문자열의 수를 제한할 수 있습니다.

추가 정보

• AutoCompleteCustomSource
• AutoCompleteSource