TextBox.AutoCompleteCustomSource Propiedad

Definición

Obtiene o establece un elemento StringCollection personalizado que se usará cuando la propiedad AutoCompleteSource esté establecida en CustomSource.

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

Valor de propiedad

StringCollection que se va a usar con AutoCompleteSource.

Atributos

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

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

Se aplica a

Consulte también