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 que el usuario pueda seleccionar varios elementos.
Para agregar un control ListBox a una página
Arrastre el control ListBox del panel de tareas Cuadro de herramientas a la página.
Establezca las propiedades del control en el panel de tareas 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 especifica un alto y un ancho, 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 establezca el alto y el ancho en píxeles, y utilizan la configuración de número de filas. |
Para obtener una descripción completa de todas las propiedades del control ListBox, vea 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 Diseño, haga clic con el botón secundario en el control ListBox y, a continuación, haga clic en Mostrar tareasde control comunes.
En el menú Tareas comunes de ListBox, 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 Diseño, haga clic con el botón secundario en el control ListBox y, a continuación, haga clic en Mostrar tareasde control comunes.
En el menú Tareas comunes de ListBox, 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.