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

Un control ListBox de Windows Forms muestra una lista de la que el usuario puede seleccionar uno o varios elementos. 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 está establecida en true, el cuadro de lista muestra los elementos de varias columnas y aparece una barra de desplazamiento horizontal. Cuando la propiedad MultiColumn está establecida en false, el cuadro de lista muestra los elementos de una sola columna y aparece una barra de desplazamiento vertical. Cuando ScrollAlwaysVisibleestá establecida en true, la barra de desplazamiento se muestra independientemente del número de elementos. La propiedad SelectionMode determina cuántos elementos de lista se pueden seleccionar a la vez.

Formas de cambiar el control ListBox

La propiedad SelectedIndex devuelve un valor entero que se corresponde con el primer elemento seleccionado del cuadro de lista. Puede cambiar el elemento seleccionado mediante programación; para ello, cambie el valor de SelectedIndex en el código, y el elemento correspondiente de la lista aparecerá resaltado en Windows Forms. Si no se selecciona ningún elemento, el valor de SelectedIndex es -1. Si se selecciona el primer elemento de la lista, el valor de SelectedIndex es 0. Si se seleccionan varios elementos, el valor de SelectedIndex refleja el elemento seleccionado que aparece en primer lugar en la lista. La propiedad SelectedItem es similar a SelectedIndex, pero devuelve el elemento en sí (normalmente un valor de cadena). La propiedad Count refleja el número de elementos de la lista, y el valor de la propiedad Count siempre es uno más que el valor más grande posible de SelectedIndex, ya que SelectedIndex se basa en cero.

Para agregar o eliminar elementos en un control ListBox, use los métodos Add, Insert, Clear o Remove. Como alternativa, puede agregar elementos a la lista mediante la propiedad Items en el tiempo de diseño.

Consulte también

• ListBox
• Procedimiento para agregar y quitar elementos de un control ComboBox, ListBox o CheckedListBox de formularios Windows Forms
• Procedimiento para ordenar el contenido de un control ComboBox, CheckedListBox o ListBox de formularios Windows Forms
• Procedimiento para enlazar un control ComboBox o ListBox de formularios Windows Forms a datos
• Información general sobre el control ComboBox
• Información general sobre el control CheckedListBox
• Controles de formularios Windows Forms usados para mostrar opciones
• Procedimiento para crear una tabla de búsqueda para un control ComboBox, ListBox o CheckedListBox de formularios Windows Forms