TextBox.AutoCompleteSource Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
Uno de los valores de AutoCompleteSource. Las opciones son AllSystemSources
, AllUrl
, FileSystem
, HistoryList
, RecentlyUsedList
, CustomSource
y None
. De manera predeterminada, es None
.
- Atributos
Excepciones
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.