Compartir a través de

TextBox.AutoCompleteSource Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Obtiene o establece un valor que especifica el origen de cadenas completas utilizadas para la finalización automática.

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

Valor de propiedad

AutoCompleteSource

Uno de los valores de AutoCompleteSource. Las opciones son AllSystemSources, AllUrl, FileSystem, HistoryList, RecentlyUsedList, CustomSource y None. De manera predeterminada, es None.

Atributos
BrowsableAttribute TypeConverterAttribute

Excepciones

InvalidEnumArgumentException

El valor especificado no es ninguno de los valores de AutoCompleteSource.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar una colección como origen personalizado de autocompletar para un TextBox control . En el ejemplo, se realizan las tareas siguientes:

  • Usa la AutoCompleteSource propiedad para permitir que el TextBox control acepte un origen personalizado para su comportamiento de autocompletar.

  • Usa la AutoCompleteCustomSource propiedad para establecer la lista personalizada de valores.

  • Usa la AutoCompleteMode propiedad para establecer cómo se muestran los candidatos de autocompletar.

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

Comentarios

Use las AutoCompleteCustomSourcepropiedades , AutoCompleteModey AutoCompleteSource para crear un TextBox objeto que complete automáticamente las cadenas de entrada comparando el prefijo especificado con los prefijos de todas las cadenas de un origen mantenido. Esto es útil para TextBox los controles en los que las direcciones URL, las direcciones, los nombres de archivo o los comandos se escribirán con frecuencia.

El uso de la AutoCompleteCustomSource propiedad es opcional, pero debe establecer la AutoCompleteSource propiedad CustomSource en para poder usar AutoCompleteCustomSource.

Debe usar las AutoCompleteMode propiedades y AutoCompleteSource juntas.

Nota

AutoCompleteSource no funciona en controles de varias líneas TextBox .

Nota

El sistema operativo puede limitar el número de cadenas personalizadas que se pueden mostrar a la vez.

Se aplica a

Consulte también