Compartir a través de


Objeto ListBox (script de formularios de Outlook)

Muestra una lista de valores y permite seleccionar uno o varios de ellos.

Comentarios

Si ListBox está enlazado a un origen de datos, ListBox guarda el valor seleccionado en ese origen de datos.

El control ListBox puede aparecer como una lista, como un grupo de controles OptionButton o como un grupo de controles CheckBox.

La propiedad predeterminada del control ListBox es Value.

El evento predeterminado del control ListBox es Click.

No es posible arrastrar texto en un control ListBox desplegable.

Estilos ListBox

Puede elegir entre dos estilos de presentación del control ListBox. Esto lo expresa la propiedad ListStyle. Cada estilo ofrece distintas formas para que los usuarios seleccionen elementos en la lista.

Si el estilo es 0, cada elemento aparece en una fila diferente y el usuario selecciona elementos resaltando una o más filas.

Si el estilo es 1, an OptionButton o CheckBox aparece al inicio de cada línea. Con este estilo, el usuario selecciona un elemento haciendo clic en el botón de opción o en la casilla de verificación. Las casillas de verificación aparecen sólo cuando la propiedad MultiSelect es True.

Eventos

Nombre Descripción
Click Se produce cuando el usuario selecciona definitivamente un valor para el control que tiene más de un valor posible.

Métodos

Nombre Descripción
AddItem En un ListBox de una única columna, el método AddItem agrega un elemento a la lista. Para un ListBox de varias columnas, este método agrega una fila a la lista.
Clear Elimina todas las entradas de la lista de un ListBox.
RemoveItem Quita una fila de la lista de un ListBox.

Propiedades

Nombre Descripción
BackColor Devuelve o establece un valor de tipo Long que especifica el color de fondo del control. Lectura y escritura.
BorderColor Devuelve o establece un valor de tipo Long que especifica el color del borde del control. Lectura/escritura.
BorderStyle Devuelve o establece un valor de tipo Integer que especifica el tipo de borde del control. Lectura/escritura.
BoundColumn Devuelve o establece un valor Variant que identifica el origen de los datos en un ListBox de múltiples columnas. Lectura y escritura.
Columna Devuelve o establece un valor Variant que representa una única columna de valores o una matriz bidimensional para cargar en un ListBox. Lectura/escritura.
ColumnCount Devuelve o establece un valor de tipo Long que representa el número de columnas que se muestran en un cuadro de lista. Lectura y escritura.
ColumnHeads Devuelve o establece un valor de tipo Boolean que indica si se muestra un única fila de encabezados de columna. Lectura y escritura.
ColumnWidths Devuelve o establece un valor String que especifica el ancho de cada columna en un ListBox de columnas múltiples. Lectura y escritura.
Enabled Devuelve o establece un valor de tipo Boolean que especifica si un control puede tomar el foco y responder a eventos generados por el usuario. Lectura/escritura.
ForeColor Devuelve o establece un valor de tipo Long que especifica el color del primer plano del control. Lectura y escritura.
IMEMode Devuelve o establece un valor Integer que especifica el modo en tiempo de ejecución predeterminado del editor de métodos de entrada (IME) de un control. Lectura y escritura.
IntegralHeight Devuelve o establece un valor de tipo Boolean que especifica si un ListBox muestran líneas completas o parciales de texto. Lectura/escritura.
Lista Devuelve o establece un valor Variant que representa la entrada especificada en un ListBox. Lectura y escritura.
ListCount Devuelve un valor de tipo Long que representa el número de entradas de una lista en un control. Solo lectura.
ListIndex Devuelve o establece un valor variant que representa el elemento seleccionado actualmente en un ListBox. Lectura y escritura.
ListStyle Devuelve o establece un valor integer que especifica la apariencia visual de la lista en un ListBox. Lectura/escritura.
Locked Devuelve o establece un valor de tipo Boolean que puede modificarse. Lectura y escritura.
MatchEntry Devuelve o establece un valor de tipo Integer que indica cómo un ListBox busca en su lista cuando el usuario escribe. Lectura/escritura.
MouseIcon Devuelve una String que representa el nombre de ruta completo de un icono personalizado que está asignado al control. Solo lectura.
MousePointer Returns or sets an Integer that specifies the type of pointer displayed when the user positions the mouse over a particular object. Lectura y escritura.
MultiSelect Devuelve o establece un valor de tipo Integer que indica si el objeta permite la selección múltiple. Lectura/escritura.
Selected Devuelve o establece un valor Boolean que indica el estado de la selección de elementos en un ListBox. Lectura y escritura.
SpecialEffect Devuelve o establece un valor de tipo Integer que especifica el aspecto visual del control. Lectura y escritura.
Texto Devuelve o establece un valor de tipo String que especifica texto en un ListBox, cambiando la fila seleccionada en el control. Lectura y escritura.
TextAlign Devuelve o establece una constante Integer que especifica el modo en que el texto se alinea en el control. Lectura/escritura.
TextColumn Devuelve o establece un valor Variant que identifica la columna especificada en un ListBox. Lectura y escritura.
TopIndex Devuelve o establece un valor de tipo Long que representa el índice del elemento de la lista mostrado en la parte superior de lista. Lectura y escritura.
Valor Devuelve o establece un valor Variant que especifica el valor de BoundColumn de las filas seleccionadas. Lectura/escritura.

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.