WP INSERER FORMULE

4D v20

WP INSERER FORMULE


WP INSERER FORMULE ( 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 INSERER FORMULE 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 Formule ou Formule sur chaine.

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 du jour avec les chaines formatées :

 C_COLLECTION($_formulas)

 C_OBJET($find;$newFormula)

 

  // définir la formule à rechercher

 $find:=Formule(Date du jour)

 

  // définir la formule de remplacement

 $newFormula:=Formule(Chaine(Date du jour;Système date long))

 

  // trouver les formules contenues dans le document

 $_formulas:=WP Lire formules(WriteProArea)

 

  // chercher la collection à partir de WP Lire formules

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

 

  // puis remplacer chaque formule

 Pour chaque($formula;$_formulas)

    WP INSERER FORMULE($formula.range;$newFormula;wk replace)

 Fin de chaque

Voir aussi

Gérer des formules
WP CALCULER FORMULES
WP FIGER FORMULES
WP Lire formules