AddItem (Método)

Agrega un nuevo elemento a un control ComboBox o ListBox; opcionalmente, permite especificar el índice del elemento.

Control.AddItem(cItem [, nIndex] [, nColumn])

Parámetros

• cItem
  Especifica la expresión de cadena que se agrega al control.

• nIndex
  Especifica la posición donde el elemento se coloca en el control. Si proporciona un valor válido para el parámetro opcional nIndex, cItem se colocará en esa posición dentro del control. Si especifica un nIndex que ya existe, el elemento se insertará en esa posición y todos los elementos por debajo del elemento se moverán una posición hacia abajo en la parte de lista del control ComboBox o ListBox.

  Si omite nIndex y la propiedad Sorted está establecida en el valor verdadero (.T.), cItem se agregará en orden alfabético. Si omite nIndex y la propiedad Sorted está establecida en el valor falso (.F.), cItem se agregará al final de la parte de lista del control ComboBox o ListBox.

• nColumn
  Especifica la columna del control al que se va a agregar el nuevo elemento. El valor predeterminado es 1.

Observaciones

Utilice el método AddItem o el método AddListItem para establecer la propiedad RowSourceType como 0 (Ninguno).

A cada elemento que se agrega a un cuadro combinado o un cuadro de lista se le asignan dos números de identificación:

• nItemID, un entero correspondiente al Id. único del elemento del control: el primer elemento corresponde a nItemID = 1, a menos que se especifique otro nItemID.
• nIndex, un entero correspondiente al orden en que el control muestra los elementos: el primer elemento del control corresponde a nIndex = 1.

Vea también

AddListItem (Método) | Clear (Método) | ListIndex (Propiedad) | ListItemID (Propiedad) | RowSourceType (Propiedad) | RemoveItem (Método) | Sorted (Propiedad)