WP INSERT FORMULA

4D v20

WP INSERT FORMULA


WP INSERT FORMULA ( objTarget ; formula ; modo {; actRango} )

Parámetro	Tipo	Descripción
objTarget	Objeto	Rango o elemento o documento 4D Write Pro
formula	Objeto	Objeto fórmula
modo	Número	Modo de inserción
actRango	Número	Incluye o excluye el contenido insertado dentro del rango

Descripción

El comando WP INSERT FORMULA inserta una formula en objTarget de acuerdo con el modo de inserción especificado.

En el parámetro objTarget, puede pasar:

un rango, o
un elemento (tabla / línea / celda(s) / párrafo / cuerpo / encabezado / pie de página / sección / subsección / imagen en línea), o
un documento 4D Write Pro.

En el parámetro formula, pase la fórmula 4D para evaluar en un objeto creado por el comando Formula o Formula from string.

En el parámetro modo, pase una de las siguientes constantes para indicar el modo de inserción que se utilizará:

Constante	Tipo	Valor	Comentario
wk append	Entero largo	2	Inserta contenidos al final del rango
wk prepend	Entero largo	1	Insertar contenidos al principio del rango
wk replace	Entero largo	0	Remplazar el contenido de la página

Si objTarget es un rango, puede utilizar el parámetro opcional actRango para pasar una de las siguientes constantes para especificar si la formula insertada se incluye o no en el rango resultante:

Constante	Tipo	Valor	Comentario
wk exclude from range	Entero largo	1	Contenidos insertados no incluidos en el rango actualizado
wk include in range	Entero largo	0	Contenido insertado incluido en el rango actualizado (predeterminado)

Si no pasa un parámetro actRango, de forma predeterminada la formula insertada se incluye en el rango resultante.

Si objTarget no es un rango, se ignora actRango.

Nota: tenga en cuenta que, cuando se llama, el objeto fórmula se evalúa dentro del contexto de la base de datos o del componente que lo creó.

Ejemplo

Para reemplazar todas las fórmulas de fecha actuales con cadenas formateadas:

 C_COLLECTION($_formulas)

 C_OBJECT($find;$newFormula)

 

  // define la fórmula a encontrar

 $find:=Formula(Current date)

 

  // define la fórmula de reemplazo

 $newFormula:=Formula(String(Current date;System date long))

 

  // busca todas las fórmulas en el documento

 $_formulas:=WP Get formulas(WriteProArea)

 

  // consulta la colección de WP Get formulas

 $_formulas:=$_formulas.query("formula.source =:1";$find.source)&NBSP;&NBSP;

 

  // luego reemplaza cada fórmula

 For each($formula;$_formulas)

    WP INSERT FORMULA($formula.range;$newFormula;wk replace)

 End for each

Ver también

Gestión de fórmulas
WP COMPUTE FORMULAS
WP FREEZE FORMULAS
WP Get formulas