WP INSERT FORMULA

4D v20

WP INSERT FORMULA


WP INSERT FORMULA ( objCible ; formule ; mode {; miseAjourPlage} )

Paramètre	Type	Description
objCible	Objet	Plage ou élément ou document 4D Write Pro
formule	Objet	Objet formule
mode	Numérique	Mode d'insertion
miseAjourPlage	Numérique	Inclut ou exclut le contenu inséré dans la plage

Description

La commande WP INSERT FORMULA insère une formule dans objCible en fonction du mode d'insertion spécifié.

Dans le paramètre objCible, vous pouvez passer :

une plage, ou
un élément (table / ligne / cellule(s) / paragraphe / corps / en-tête / pied / section / sous-section / image en ligne), ou
un document 4D Write Pro.

Dans le paramètre formule, passez la formule 4D à évaluer dans un objet créé par la commande Formula ou Formula from string.

Dans le paramètre mode, passez l'une des constantes suivantes pour indiquer le mode d'insertion à utiliser :

Constante	Type	Valeur	Comment
wk append	Entier long	2	Insère le contenu à la fin de la cible
wk prepend	Entier long	1	Le contenu est inséré au début de la cible
wk replace	Entier long	0	Remplace le contenu de la cible

Si objCible est une plage, vous pouvez utiliser le paramètre optionnel miseAjourPlage pour passer l'une des constantes suivantes pour spécifier si la formule insérée est inclue ou non dans la plage résultante :

Constante	Type	Valeur	Comment
wk exclude from range	Entier long	1	Le contenu inséré n'est pas inclus dans la plage mise à jour
wk include in range	Entier long	0	Le contenu inséré est inclus dans la plage mise à jour (défaut)

Si vous ne passez pas un paramètre rangeUpdate, la formule insérée est inclue par défaut dans la plage résultante.

Si objCible n'est pas une plage, rangeUpdate est ignoré.

Note: N'oubliez pas que, lorsqu'il est appelé, l'objet formule est évalué dans le contexte de la base de données ou du composant qui l'a créé.

Exemple

Pour remplacer les formules Date courante avec les chaines formatées :

 C_COLLECTION($_formulas)

 C_OBJECT($find;$newFormula)</p><p> // définir la formule à rechercher

 $find:=Formula(Current date)

 

  // définir la formule de remplacement

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

 

  // trouver les formules contenues dans le document

 $_formulas:=WP Get formulas(WriteProArea)

 

  // rechercher la collection à partir de WP Get formulas

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

 

  // puis remplacer chaque formule

 For each($formula;$_formulas)

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

 End for each

Voir aussi

Gérer des formules
WP COMPUTE FORMULAS
WP FREEZE FORMULAS
WP Get formulas