Método ListBox. AddItem (Access)ListBox.AddItem method (Access)

Agrega un nuevo elemento a la lista de valores mostrada en el control de cuadro de lista especificado.Adds a new item to the list of values displayed by the specified list box control.

SintaxisSyntax

expresión. AddItem (Elemento, Índice)expression.AddItem (Item, Index)

expresión Variable que representa un objeto ListBox .expression A variable that represents a ListBox object.

ParámetrosParameters

NombreName Obligatorio/opcionalRequired/Optional Tipo de datosData type DescripciónDescription
ItemItem ObligatorioRequired StringString Texto que se muestra para el nuevo elemento.The display text for the new item.
IndexIndex OpcionalOptional VariantVariant Posición del elemento en la lista.The position of the item in the list. Si se omite este argumento, el elemento se agrega al final de la lista.If this argument is omitted, the item is added to the end of the list.

ComentariosRemarks

La propiedad RowSourceType del control especificado debe establecerse en Value List.The RowSourceType property of the specified control must be set to Value List.

Este método sólo es válido para los controles de cuadro de lista o cuadro combinado de los formularios.This method is only valid for list box or combo box controls on forms.

Los números de elemento de lista comienzan por cero.List item numbers start from zero. Si el valor del argumento Item no corresponde a un número de elemento existente, se produce un error.If the value of the Item argument doesn't correspond to an existing item number, an error occurs.

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).For multiple-column lists, use semicolons to delimit the strings for each column (for example, "1010;red;large" for a three-column list). Si el argumento Item contiene menos cadenas que columnas en el control, los elementos se agregarán comenzando por la columna situada más a la izquierda.If the Item argument contains fewer strings than columns in the control, items will be added starting with the left-most column. Si el argumento Item contiene más cadenas que columnas en el control, las cadenas adicionales se omiten.If the Item argument contains more strings than columns in the control, the extra strings are ignored.

Utilice el método RemoveItem para quitar elementos de la lista de valores.Use the RemoveItem method to remove items from the list of values.

EjemploExample

En este ejemplo se agrega un elemento al final de la lista en un control de cuadro de lista.This example adds an item to the end of the list in a list box control. 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.For the function to work, you must pass it a ListBox object representing a list box control on a form and a String value representing the text of the item to be added.

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.This example adds an item to the beginning of the list in a combo box control. 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.For the function to work, you must pass it a ComboBox object representing a combo box control on a form and a String value representing the text of the item to be added.

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

Soporte técnico y comentariosSupport and feedback

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.