ListBox (control)
El control ListBox permite a los usuarios seleccionar uno o varios elementos de una lista predefinida. Se diferencia de un control DropDownList en que puede mostrar varios elementos a la vez y, de manera opcional, permite al usuario seleccionar varios elementos.
Para agregar un control ListBox a una página
Arrastre el control ListBox del panel Cuadro de herramientas a la página.
Establezca las propiedades del control en el panel Propiedades de etiqueta.
Propiedades comunes de ListBox
Property |
Descripción |
|---|---|
SelectionMode |
Establezca el valor de esta propiedad en Single o Multiple para especificar el número de elementos que pueden seleccionar los usuarios. |
Rows |
Especifica el número de filas que se muestran. Puede definir el control para que muestre un número específico de elementos. Si el control contiene más elementos, muestra una barra de desplazamiento vertical. |
Height y Width |
Especifica el tamaño del control en píxeles. Cuando se especifican las propiedades Height y Width, el control omite el número de filas establecido y muestra tantas filas como quepan en el alto del control. Algunos exploradores no admiten que se establezcan los valores Height y Width en píxeles, y usan la configuración de número de filas. |
Para obtener una descripción completa de todas las propiedades del control ListBox, vea el artículo ListBox (Propiedades) en MSDN Library.
Agregar elementos al control ListBox
Para que un control ListBox pueda presentar a un usuario elementos entre los que elegir, deberá rellenar el control ListBox con los elementos. Para ello, puede enlazar el control a un origen de datos o definir individualmente elementos para el control ListBox.
Para enlazar el control ListBox a un origen de datos
En la Vista de diseño, haga clic con el botón secundario en el control ListBox y, a continuación, haga clic en Mostrar tareas de control comunes.
En el menú Tareas de DropDownList, haga clic en Elegir origen de datos.
En el Asistente para la configuración de orígenes de datos, elija un origen para el control ListBox en el menú desplegable Seleccionar un origen de datos. En el menú desplegable Seleccionar un campo de datos para mostrar enListBox, seleccione el campo del texto que verá el usuario. En el menú desplegable Seleccionarun campo de datos para el valor de ListBox, seleccione el campo para los datos a los que se puede tener acceso mediante programación cuando el usuario elija un elemento en la lista.
Para definir elementos para el control ListBox
En la Vista de diseño, haga clic con el botón secundario en el control ListBox y, a continuación, haga clic en Mostrar tareas de control comunes.
En el menú Tareas de DropDownList, haga clic en Editar elementos.
En el cuadro de diálogo Editor de la colección ListItem, haga clic en Agregar para agregar un elemento.
En el área Propiedades de ListItem, establezca las propiedades Text y Value.
Repita los pasos 3 y 4 hasta que haya agregado todos los elementos que desee.