LISTBOX INSERT COLUMN FORMULA

4D v16.3


LISTBOX INSERT COLUMN FORMULA ( {* ;} objeto ; posicionCol ; nomCol ; formula ; tipoDatos ; nomEncabezado ; varEncabezado {; nomPie ; variablePie} )

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 del 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
formula	Cadena	Fórmula 4D asociada a la columna
tipoDatos	Entero largo	Tipo de resultado de la fórmula
nomEncabezado	Cadena	Nombre del objeto del encabezado de la columna
varEncabezado	Variable entera, Puntero nulo	Variable del encabezado de la columna
nomPie	Cadena	Nombre del objeto de pie de la columna
variablePie	Variable, Puntero nulo	Variable de pie de columna

Descripción

El comando LISTBOX INSERT COLUMN FORMULA inserta una columna en el listbox designado por los parámetros objeto y *.
El comando LISTBOX INSERT COLUMN FORMULA es similar al comando LISTBOX INSERT COLUMN excepto que puede utilizarse para introducir una fórmula como contenido de una columna.

Este tipo de contenido sólo puede utilizarse cuando la propiedad “Fuente de datos” del list box es Selección actual o Selección temporal (para mayor información al respecto, consulte la sección Gestión programada de los objetos de tipo List box).

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

Si pasa el parámetro opcional *, indica que el parámetro objeto es un nombre de objeto (cadena). Si no pasa este parámetro, indica que el parámetro objeto es una variable. En este caso, no pase una cadena sino una referencia de variable. Para mayor información sobre los nombres de objetos, consulte la sección Propiedades de los objetos.

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

Pase en el parámetro nomCol el nombre del objeto de la columna insertada.

El parámetro formula puede contener cualquier expresión válida:

Una instrucción,
Una fórmula generada utilizando el editor de fórmulas,
Una llamada a un comando 4D,
Una llamada a un método proyecto.

En el momento de la llamada del comando, la formula se analiza y luego se ejecuta.

Nota: utilice el comando Command name para definir las fórmulas independientes del lenguaje de la aplicación (cuando llaman a comandos 4D).

El parámetro tipoDatos puede utilizarse para designar el tipo de datos resultantes de la ejecución de la formula. Debe pasar en este parámetro una de las siguientes constantes del tema Tipos de campos y variables:

Constante	Tipo	Valor
Is Boolean	Entero largo	6
Is date	Entero largo	4
Is picture	Entero largo	3
Is real	Entero largo	1
Is text	Entero largo	2
Is time	Entero largo	11

Si el resultado de la formula no corresponde al tipo de datos esperado, se genera un error.

Pase en los parámetros nomEncabezado y varEncabezado el nombre de objeto y la variable del encabezado de la columna insertada.

También 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 utilizará una variable dinámica.

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

Inserción dinámica

A partir de 4D v14 R3, puede utilizar este comando para insertar columnas en los list box de forma dinámica durante la ejecución del formulario. 4D manejará automáticamente la definición de las variables necesarias (pie de página y encabezado).

Para ello, LISTBOX INSERT COLUMN FORMULA acepta un puntero Nil (->[]) como valor para los parámetros varEncabezado y variablePie. En este caso, cuando se ejecuta el comando, 4D crea las variables requeridas dinámicamente (para más información, consulte la sección Variables dinámicas).

Note que las variables de encabezado y de pie de página siempre se crean con un tipo específico (entero largo y texto, respectivamente).

Ejemplo

Queremos añadir una nueva columna a la derecha del listbox que contendrá una fórmula que calcula la edad de un empleado:

 vEdad:="Fecha actual-[Empleados]FechaNacimiento)\365"

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

 LISTBOX INSERT COLUMN FORMULA(*;"ListBox1";$ultima;"ColFormula";vEdad;Is real;"Edad";varEncabezado)

Ver también

LISTBOX INSERT COLUMN