Compartir a través de


Información general sobre ListBox (Control, formularios Windows Forms)

Un control ListBox de formularios Windows Forms muestra una lista de elementos entre los que el usuario puede seleccionar uno o más. Si el número total de elementos supera el número que se puede mostrar, se agrega automáticamente una barra de desplazamiento al control ListBox. Cuando la propiedad MultiColumn se establece en true, el cuadro de lista muestra elementos en varias columnas y aparece una barra de desplazamiento horizontal. Cuando la propiedad MultiColumn se establece en false, el cuadro de lista muestra los elementos en una sola columna y aparece una barra de desplazamiento vertical. Cuando ScrollAlwaysVisible se establece en true, la barra de desplazamiento aparece, independientemente del número de elementos. La propiedad SelectionMode determina cuántos elementos de la lista pueden seleccionarse a la vez.

Maneras de modificar el control ListBox

La propiedad SelectedIndex devuelve un valor entero que corresponde al primer elemento seleccionado en el cuadro de lista. Para cambiar mediante programación el elemento seleccionado, cambie el valor de SelectedIndex en el código; el elemento correspondiente de la lista aparecerá resaltado en el formulario Windows Forms. Si no se selecciona ningún elemento, el valor de SelectedIndex es -1. Si el primer elemento de la lista está seleccionado, el valor de SelectedIndex es 0. Cuando varios elementos están seleccionados, el valor SelectedIndex refleja el elemento seleccionado que aparece primero en la lista. La propiedad SelectedItem es similar a SelectedIndex, pero devuelve el elemento en sí, habitualmente un valor de cadena. La propiedad Count refleja el número de elementos de la lista. El valor de la propiedad Count es siempre una unidad más que el máximo valor posible para SelectedIndex, ya que SelectedIndex está basada en cero.

Para agregar o eliminar los elementos en un control ListBox, utilice el método Add, Insert, Clear o Remove. También puede agregar elementos a la lista mediante la propiedad Items en tiempo de diseño.

Vea también

Tareas

Cómo: Agregar y quitar elementos de un control ComboBox, CheckedListBox o ListBox de formularios Windows Forms

Cómo: Ordenar el contenido de un control ComboBox, CheckedListBox o ListBox de formularios Windows Forms

Cómo: Enlazar un control ComboBox o ListBox de formularios Windows Forms a datos

Cómo: Crear una tabla de búsqueda para un control ComboBox, ListBox o CheckedListBox de Windows Forms

Referencia

Información general sobre el control ComboBox (formularios Windows Forms)

Información general sobre el control CheckedListBox (formularios Windows Forms)

ListBox

Otros recursos

Controles de formularios Windows Forms usados para mostrar opciones