TextBox.AutoCompleteCustomSource 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

AutoCompleteSource 속성이 CustomSource(으)로 설정된 경우 사용할 사용자 지정 StringCollection을(를) 가져오거나 설정합니다.

public:
 property System::Windows::Forms::AutoCompleteStringCollection ^ AutoCompleteCustomSource { System::Windows::Forms::AutoCompleteStringCollection ^ get(); void set(System::Windows::Forms::AutoCompleteStringCollection ^ value); };

[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.AutoCompleteStringCollection AutoCompleteCustomSource { get; set; }

[<System.ComponentModel.Browsable(true)>]
member this.AutoCompleteCustomSource : System.Windows.Forms.AutoCompleteStringCollection with get, set

Public Property AutoCompleteCustomSource As AutoCompleteStringCollection

속성 값

AutoCompleteStringCollection

StringCollection에 사용할 AutoCompleteSource입니다.

특성

BrowsableAttribute

예제

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