TextBox.AutoCompleteMode TextBox.AutoCompleteMode TextBox.AutoCompleteMode TextBox.AutoCompleteMode Property

정의

TextBox의 자동 완성 기능이 작동하는 방법을 제어하는 옵션을 가져오거나 설정합니다.Gets or sets an option that controls how automatic completion works for the 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; }
member this.AutoCompleteMode : System.Windows.Forms.AutoCompleteMode with get, set
Public Property AutoCompleteMode As AutoCompleteMode

속성 값

AutoCompleteMode의 다음 값 중 하나입니다.One of the values of AutoCompleteMode. 값은 다음과 같습니다.The following are the values.

Append
가장 가능성 있는 후보 문자열의 나머지를 기존 문자에 추가하고 추가된 문자를 강조 표시합니다.Appends the remainder of the most likely candidate string to the existing characters, highlighting the appended characters.

Suggest
edit 컨트롤과 연결된 보조 드롭다운 목록을 표시합니다.Displays the auxiliary drop-down list associated with the edit control. 이 드롭다운 목록은 제시된 하나 이상의 완성 문자열로 채워집니다.This drop-down is populated with one or more suggested completion strings.

SuggestAppend
SuggestAppend 옵션을 모두 추가합니다.Appends both Suggest and Append options.

None
자동 완성을 사용하지 않습니다.Disables automatic completion. 이 값이 기본값입니다.This is the default.

예외

지정한 값이 AutoCompleteMode의 값이 아닌 경우The specified value is not one of the values of AutoCompleteMode.

예제

다음 코드 예제에 대 한 사용자 지정 원본 자동 완성으로 컬렉션을 사용 하는 방법에 설명 된 TextBox 제어 합니다.The following code example demonstrates how to use a collection as the auto-complete custom source for a TextBox control. 이 예제에서는 다음을 수행합니다.This example does the following:

  • 사용 하 여는 AutoCompleteSource 속성을 사용 합니다 TextBox 자동 완성 동작에 대 한 사용자 지정 원본을 적용할 컨트롤입니다.Uses the AutoCompleteSource property to enable the TextBox control to accept a custom source for its auto-complete behavior.

  • 사용 된 AutoCompleteCustomSource 속성 값의 사용자 지정 목록을 설정 합니다.Uses the AutoCompleteCustomSource property to set the custom list of values.

  • 사용 하는 AutoCompleteMode 속성을 자동 완성 지원 자가 표시 되는 방식을 설정 합니다.Uses the AutoCompleteMode property to set how the auto-complete candidates are displayed.

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 입력된 문자열을 관리 되는 소스에서 모든 문자열의 접두사를 입력 되는 접두사를 비교 하 여 자동으로 완료 하는 합니다.Use the AutoCompleteCustomSource, AutoCompleteMode, and AutoCompleteSource properties to create a TextBox that automatically completes input strings by comparing the prefix being entered to the prefixes of all strings in a maintained source. 유용 TextBox 컨트롤은 Url, 주소, 파일 이름 또는 명령을 자주 입력 됩니다.This is useful for TextBox controls in which URLs, addresses, file names, or commands will be frequently entered.

사용 된 AutoCompleteCustomSource 속성은 선택 사항 이지만 설정 해야 합니다는 AutoCompleteSource 속성을 CustomSource 사용 하려면 AutoCompleteCustomSource합니다.The use of the AutoCompleteCustomSource property is optional, but you must set the AutoCompleteSource property to CustomSource in order to use AutoCompleteCustomSource.

사용 해야 합니다 AutoCompleteModeAutoCompleteSource 속성을 함께 합니다.You must use the AutoCompleteMode and AutoCompleteSource properties together.

참고

운영 체제는 한 번에 표시할 수 있는 사용자 지정 문자열의 수를 제한할 수 있습니다.The operating system might limit the number of custom strings that it can display at once.

적용 대상

추가 정보