4D Doc Center : LISTBOX INSERT COLUMN

4D v13.4

LISTBOX INSERT COLUMN


LISTBOX INSERT COLUMN ( {* ;} objeto ; posicionCol ; nomCol ; variableCol ; nomEncabezado ; varTitulo {; nomPie ; nomVar} )

Parámetro	Tipo	Descripción
*	Operador	Si se especifica, objeto es un nombre de objeto (cadena) Si se omite, objeto es una variable
objeto	Objeto de formulario	Nombre de objeto (si se especifica ) o Variable (si se omite )
posicionCol	Entero largo	Ubicación de la columna a insertar
nomCol	Cadena	Nombre del objeto de la columna
variableCol	Array, Campo, Variable	Nombre de la variable de la columna
nomEncabezado	Cadena	Nombre del objeto del título de la columna
varTitulo	Variable entera	Variable de título de la columna
nomPie	Cadena	Nombre del objeto de pie de la columna
nomVar	Variable entera	Variable de pie de la columna

Descripción

El comando LISTBOX INSERT COLUMN inserta una columna en el list box designado por los parámetros objeto y *.

Nota: este comando no hace nada si se aplica a la primera columna de un lisbox mostrado en modo jerárquico.

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.

La nueva columna se inserta justo en frente de la columna definida por el parámetro posicionCol. Si el parámetro posicionCol es superior al número total de columnas, la columna se añade después de la última columna.

Pase el nombre del objeto y de la variable de la columna insertada en los parámetros nomCol y variableCol.

Con un array tipo list box, el nombre de la variable debe coincidir con el nombre del array cuyo contenido se mostrará en la columna.
Con una selección tipo list box, debe pasar un campo o variable en el parámetro variableCol. El contenido de la columna será entonces el valor del campo o de la variable, evaluado para cada registro de la selección asociada al list box. Este tipo de contenidos sólo puede ser utilizado cuando la propiedad "Fuente de datos" del list box es Selección actual o Selección temporal (ver la sección Gestión de los objetos de tipo List box). Puede utilizar los campos o las variables de tipo cadena, numérico, Fecha, Hora, Imagen y Booleano.

En el contexto de list boxes basadas en selecciones, LISTBOX INSERT COLUMN puede ser utilizado para insertar elementos simples (campos o variables). Si quiere manipular expresiones más complejas (tales como fórmulas o métodos), debe utilizar el comando LISTBOX INSERT COLUMN FORMULA.

Nota: no es posible combinar en un mismo list box columnas de tipo array (fuente de datos array) y columnas de tipo campo o variable (fuente de datos selección).

Pase el nombre del objeto y de la variable del título de la columna insertada en los parámetros nomEncabezado y varEncabezado Parámetros.

Puede pasar en los parámetros nomPie y variablePie, el nombre del objeto y la variable del pie de la columna insertada. Si omite el parámetro variablePie, 4D utiliza una variable dinámica.

Nota: los nombres de los objetos deben ser únicos en un formulario. Debe asegurarse de que los nombres pasados en los parámetros nomCol, nomTitulo y nomPie no hayan sido utilizados. De lo contrario, la columna no sea crea y se genera un error.

Ejemplo 1

Nos gustaría añadir una columna al final del list box:

 C_LONGINT(NomVarTitulo;$Ultimo;RecNum)

 ALL RECORDS([Tabla 1])

 $RecNum:=Records in table([Tabla 1])

 ARRAY PICTURE(Imagen;$RecNum)

 

 $Ultimo:=LISTBOX Get number of columns(*;"ListBox1")+1

 LISTBOX INSERT COLUMN(*;"ListBox1";$Ultimo;"ColumnImagen";Imagen;"imagenTitulo";NomVarTitulo)

Ejemplo 2

Nos gustaría añadir una columna a la derecha del list box y asociarle los valores del campo [Transporte]Tarifas:

 $Ultimo:=LISTBOX Get number of columns(*;"ListBox1")+1

 LISTBOX INSERT COLUMN(*;"ListBox1";$Ultimo;"CampoCol";[Transporte]Tarifas;"nomTitulo";varTitulo)