Método ListBox.AddItem (Access)

Agrega un nuevo elemento a la lista de valores que muestra el control de cuadro de lista especificado.

Sintaxis

expresión. AddItem (Item, Index)

expresión Variable que representa un objeto ListBox.

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
Item Obligatorio String Texto que se muestra para el nuevo elemento.
Index Opcional Variant Posición del elemento en la lista. Si se omite este argumento, el elemento se agrega al final de la lista.

Comentarios

La propiedad RowSourceType del control especificado debe establecerse en Lista de valores.

Este método sólo es válido para los controles de cuadro de lista o cuadro combinado de los formularios.

Los números de elemento de lista comienzan por cero. Si el valor del argumento Item no corresponde a un número de elemento existente, se produce un error.

Para las listas con varias columnas, use punto y coma para delimitar las cadenas de cada columna (por ejemplo, "1010;rojo;grande" para una lista con tres columnas). Si el argumento Item contiene menos cadenas que columnas en el control, los elementos se agregarán a partir de la columna más izquierda. Si el argumento Item contiene más cadenas que columnas en el control, las cadenas adicionales se omiten.

Utilice el método RemoveItem para quitar elementos de la lista de valores.

Ejemplo

En este ejemplo se agrega un elemento al final de la lista en un control de cuadro de lista. Para que la función realice su trabajo, deberá transmitirle un objeto ListBox que represente un control de cuadro de lista en un formulario y un valor Cadena que represente el texto del elemento que se debe agregar.

Function AddItemToEnd(ctrlListBox As ListBox, _ 
 ByVal strItem As String) 
 
 ctrlListBox.AddItem Item:=strItem 
 
End Function

En este ejemplo se agrega un elemento al comienzo de la lista en un control de cuadro combinado. Para que la función realice su trabajo, deberá transmitirle un objeto ComboBox que represente un control de cuadro combinado en un formulario y un valor Cadena que represente el texto del elemento que debe agregarse.

Function AddItemToBeginning(ctrlComboBox As ComboBox, _ 
 ByVal strItem As String) 
 
 ctrlComboBox.AddItem Item:=strItem, Index:=0 
 
End Function

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.