TextBox.AutoCompleteSource 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

자동 완성 기능에 사용되는 전체 문자열의 소스를 지정하는 값을 가져오거나 설정합니다.

public:
 property System::Windows::Forms::AutoCompleteSource AutoCompleteSource { System::Windows::Forms::AutoCompleteSource get(); void set(System::Windows::Forms::AutoCompleteSource value); };

[System.ComponentModel.Browsable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.TextBoxAutoCompleteSourceConverter))]
public System.Windows.Forms.AutoCompleteSource AutoCompleteSource { get; set; }

[<System.ComponentModel.Browsable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.TextBoxAutoCompleteSourceConverter))>]
member this.AutoCompleteSource : System.Windows.Forms.AutoCompleteSource with get, set

Public Property AutoCompleteSource As AutoCompleteSource

속성 값

AutoCompleteSource

AutoCompleteSource 값 중 하나입니다. 옵션은 AllSystemSources, AllUrl, FileSystem, HistoryList, RecentlyUsedList, CustomSource 및 None입니다. 기본값은 None입니다.

특성

BrowsableAttribute TypeConverterAttribute

예외

InvalidEnumArgumentException

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

예제

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

참고

AutoCompleteSource 는 여러 줄 TextBox 컨트롤에서 작동하지 않습니다.

참고

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

추가 정보

• AutoCompleteCustomSource
• AutoCompleteMode