versión 11
INSERT LISTBOX COLUMN FORMULA ({*; }objeto; posicionCol; nomCol; formula; tipoDatos; nomEncabezado; varEncabezado)
| Parámetro | Tipo | Descripción | |
| * | * | 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 | Numérico | 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 Entero | Variable del encabezado de la columna |
Descripción
El comando INSERT LISTBOX COLUMN FORMULA inserta una columna en el listbox designado por los parámetros objeto y *.
El comando INSERT LISTBOX COLUMN FORMULA es similar al comando INSERT LIST BOX 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).
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 de 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 Real | Entero largo | 1 |
| Is Text | Entero largo | 2 |
| Is Picture | Entero largo | 3 |
| Is Date | Entero largo | 4 |
| Is Boolean | Entero largo | 6 |
| 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.
Nota: los nombres de objeto deben ser únicos en un formulario. Debe asegurarse de que los nombres pasados en los parámetros nomCol y nomEncabezado 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:=Get number of listbox columns(*;"ListBox1")+1 INSERT LISTBOX COLUMN FORMULA(*;"ListBox1";$ultima;"ColFormula";Is Real;vEdad;"Edad";varEncabezado)
Ver también