TextBox.AutoCompleteSource 屬性

定義

取得或設定值,以指定用於自動完成的完整字串來源。Gets or sets a value specifying the source of complete strings used for automatic completion.

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; }
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
member this.AutoCompleteSource : System.Windows.Forms.AutoCompleteSource with get, set
Public Property AutoCompleteSource As AutoCompleteSource

屬性值

AutoCompleteSource

其中一個 AutoCompleteSource 值。One of the values of AutoCompleteSource. 這些選項包括 AllSystemSourcesAllUrlFileSystemHistoryListRecentlyUsedListCustomSourceNoneThe options are AllSystemSources, AllUrl, FileSystem, HistoryList, RecentlyUsedList, CustomSource, and None. 預設為 NoneThe default is None.

屬性

例外狀況

指定值不是 AutoCompleteSource 的其中一個值。The specified value is not one of the values of AutoCompleteSource.

範例

下列程式碼範例示範如何使用集合做為控制項的自動完成自訂來源 TextBoxThe following code example demonstrates how to use a collection as the auto-complete custom source for a TextBox control. 此範例會執行下列各項:This example does the following:

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 使用 AutoCompleteCustomSourceThe 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.

注意

AutoCompleteSource 無法在多行控制項上運作 TextBoxAutoCompleteSource does not work on multiline TextBox controls.

注意

作業系統可能會限制可以一次顯示的自訂字串數目。The operating system might limit the number of custom strings that can be displayed at once.

適用於

另請參閱