Este es el sitio web histórico de la documentación de 4D. La documentación se está trasladando progresivamente a developer.4d.com

Inicio

 
4D v19
WP INSERT FORMULA

WP INSERT FORMULA 


 

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

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)  
 
  // 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

 
PROPIEDADES 

Producto: 4D
Tema: Lenguaje 4D Write Pro
Número 1703

This command can be run in preemptive processes

 
CONTENIDO DE LA PÁGINA 
 
HISTORIA 

Creado por: 4D v18 R2

 
ARTICLE USAGE

Referencia 4D Write Pro ( 4D v19)