4D Doc Center : LISTBOX INSERT COLUMN FORMULA

4D v13.4

LISTBOX INSERT COLUMN FORMULA


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	Variable del encabezado de la columna
nomPie	Cadena	Nombre del objeto de pie de la columna
variablePie	Variable entera	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 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.

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";Is Real;vEdad;"Edad";varEncabezado)