TextBox.AutoCompleteMode Propiedad

  • Referencia

Definición

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

Obtiene o establece una opción que controla cómo funciona la finalización automática para TextBox.

public:
 property System::Windows::Forms::AutoCompleteMode AutoCompleteMode { System::Windows::Forms::AutoCompleteMode get(); void set(System::Windows::Forms::AutoCompleteMode value); };
[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.AutoCompleteMode AutoCompleteMode { get; set; }
[<System.ComponentModel.Browsable(true)>]
member this.AutoCompleteMode : System.Windows.Forms.AutoCompleteMode with get, set
Public Property AutoCompleteMode As AutoCompleteMode

Valor de propiedad

AutoCompleteMode

Uno de los valores de AutoCompleteMode. Los valores son los siguientes.

Append
Anexa el resto de la cadena del candidato más probable a los caracteres existentes, y resalta los caracteres anexados.

Suggest
Muestra la lista desplegable auxiliar asociada al control de edición. Esta lista desplegable se rellena con una o más cadenas de finalización sugeridas.

SuggestAppend
Anexa tanto la opción Suggest como Append.

None
Deshabilita la realización automática. Este es el valor predeterminado.

Atributos
BrowsableAttribute

Excepciones

InvalidEnumArgumentException

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

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