LISTBOX INSERT ROWS
LISTBOX INSERT ROWS ( {* ;} objeto ; posicionL {; numLineas} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| * | Operador | → | Si se especifica, objeto es un nombre de objeto (cadena) Si se omite, objeto es una variable |
| objeto | any | → | Nombre de objeto (si se especifica *) o Variable (si se omite *) |
| posicionL | Integer | → | Posición de la fila a insertar |
| numLineas | Integer | → | Número de líneas a insertar |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
El comando LISTBOX INSERT ROWS inserta una o varias nuevas líneas en el list box designado por los parámetros objeto y *.
Nota: este comando funciona únicamente con los list box basados en arrays. Cuando este comando se utiliza con un list box basado en una selección, no hace nada y la variable sistema OK toma el valor 0.
Si pasa el parámetro opcional *, indica que el parámetro objeto es un nombre de objeto (cadena). Si omite este parámetro, indica que el parámetro objeto es una variable. En ese caso, no pasa una cadena, sino una referencia de variable. Para mayor información sobre nombres de objetos, consulte la sección Propiedades de los objetos.
Por defecto, si se omite el parámetro numLineas, sólo se inserta una línea. De lo contrario, el comando inserta el número de líneas definido en este parámetro.
La fila se inserta en la posición definida por el parámetro posicionL. Una nueva fila se añade automáticamente en esta posición en todos los arrays utilizados por las columnas del list box, cualquiera que sea su tipo y visibilidad.
Si el valor de posicionL es mayor que el número total de filas en el list box, la fila se añade al final de cada array. Si es igual a 0, la fila se añade al principio de cada array. Si contiene un valor negativo, el comando no hace nada.