4D Doc Center : CT INSERT FIELD

4D Chart v13

CT INSERT FIELD


CT INSERT FIELD ( area ; alcance ; primer ; ultimo ; numTabla ; numCampo ; formato )

Parámetro	Tipo	Descripción
area	Entero largo	Área 4D Chart
alcance	Entero largo	-1 = Primer objeto del documento 0 = Primer objeto de la selección >0 = Objeto ID
primer	Entero	Posición del primer carácter menos 1
ultimo	Entero	Posición del último carácter
numTabla	Entero	Número de referencia de la tabla
numCampo	Entero	Número de referencia del campo
formato	Cadena	Formato de referencia

Descripción

El comando CT INSERT FIELD inserta una referencia del campo al interior del objeto texto en area descrito por alcance.

Si alcance es igual a -1, CT INSERT FIELD inserta la referencia en el primer objeto del documento.
Si alcance es igual a 0, CT INSERT FIELD inserta la referencia en el primer objeto seleccionado.
Si alcance es mayor que 0, debe ser igual al ID de un objeto texto específico y la referencia se inserta dentro de ese objeto texto. Si el objeto no existe, CT INSERT FIELD no hace nada.

Si el objeto descrito por alcance no es un objeto texto, CT INSERT FIELD no hace nada.

primer y ultimo determinan donde se inserta la referencia. primer es uno menos que la posición del primer carácter a reemplazar y ultimo es la posición del último carácter a reemplazar. Si primer es igual a ultimo, ningún carácter se reemplaza y la referencia se inserta entre primer y primer +1. Si ultimo es mayor que el número de caracteres del objeto texto, CT INSERT FIELD reemplaza los caracteres desde primer hasta el último carácter en el objeto texto.

tabla y campo determinan el campo referenciado. tabla es el número de la tabla y campo es el número del campo. Las tablas y los campos se numeran en el orden en que fueron creados.

El parámetro opcional formato es el formato de visualización de la referencia. Esta opción es equivalente a elegir un formato en la caja de diálogo Formato. Puede hacer referencia a los formatos por su número o por su nombre. Los formatos se numeran en el orden en que aparecen en la lista de la caja de diálogo Formato.

Si formato es una cadena de uno o dos dígitos, entonces el formato aplicado al campo es de la lista. Si formato no es una cadena de uno o dos dígitos, se compara con los valores textos de cada formato en la lista. Si coincide con uno de los valores de la lista, se aplica ese formato. Esto significa que se puede hacer referencia al primer formato de fecha como "19" o "Corto".

Si formato no está en la lista de los formatos, se interpreta como un formato numérico personalizado. Si formato no es apropiado para el valor resultante de la referencia, se ignora. Por ejemplo, si utiliza un formato de fecha para un número, el número aparece sin formato.

Ejemplo 1

Este ejemplo inserta una referencia al primer campo de la primera tabla, en el objeto texto que tiene 1 como identificador, remplazando todo texto en el objeto y luego le da formato de acuerdo al undécimo formato en la lista.

CT INSERT FIELD(Area;1;0;32000;1;1;"11")

Ejemplo 2

Puede utilizar las funciones 4D Field y Table para indicar el número de campo o de tabla. Esto puede facilitar la lectura de su código. Por ejemplo, si el campo utilizado en el ejemplo anterior es [Clientes]Nombre, el código se vería así:

CT INSERT FIELD(Area;1;0;32000;Table(->[Clientes]);Field(->Nombre);"11")