WP INSERT FORMULA

Home

4D v20

WP INSERT FORMULA


WP INSERT FORMULA ( targetObj ; formula ; mode {; rangeUpdate} )

Parameter	Typ	Beschreibung
targetObj	Objekt	Range oder Element oder 4D Write Pro Dokument
formula	Objekt	Objekt Formel
mode	Zahl	Einfügemodus
rangeUpdate	Zahl	Fügt eingefügten Inhalt im Range ein oder nicht

Beschreibung

Der Befehl WP INSERT FORMULA fügt eine formula in targetObj gemäß dem Einfügemodus mode ein.

Im Parameter targetObj übergeben Sie:

ein Range oder
ein Element (Tabelle / Zeile / Zelle(n) / Absatz / Hauptteil / Kopfteil / Fußteil / Abschnitt / Unterabschnitt / eingebundenes Bild) oder
ein 4D Write Pro Dokument

Im Parameter formula übergeben Sie die 4D Formel zum Berechnen in einem Objekt, das mit dem Befehl Formula oder Formula from string erstellt wurde.

Im Parameter mode übergeben Sie eine der folgenden Konstanten für den Einfügemodus:

Konstante	Typ	Wert	Kommentar
wk append	Lange Ganzzahl	2	Fügt Inhalt am Ende des Ziels ein
wk prepend	Lange Ganzzahl	1	Fügt Inhalt am Anfang des Elements ein
wk replace	Lange Ganzzahl	0	Ersetzt Inhalt in Ziel

Ist targetObj ein Range, können Sie über den optionalen Parameter rangeUpdate eine der folgenden Konstanten übergeben, die definieren, ob die eingefügte formula im Ziel Range enthalten ist oder nicht:

Konstante	Typ	Wert	Kommentar
wk exclude from range	Lange Ganzzahl	1	Eingefügter Inhalt ist nicht im aktualisierten Range enthalten
wk include in range	Lange Ganzzahl	0	Eingefügter Inhalt ist im aktualisierten Range enthalten (Standard)

Ohne den Parameter rangeUpdate wird standardmäßig die eingefügte Formel formula im Ziel Range eingefügt.

Ist targetObj kein Range, wird rangeUpdate ignoriert.

Hinweis: Beachten Sie, dass das Formel-Objekt beim Aufruf im Kontext der Datenbank oder der Komponente ausgewertet wird, die es erstellt hat.

Beispiel

Alle Formeln für aktuelles Datum durch formatierte Strings ersetzen:

 C_COLLECTION($_formulas)

 C_OBJECT($find;$newFormula)

 

  // define the formula to find

 $find:=Formula(Current date)

 

  // define the replacement formula

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

 

  // find all formulas in the document

 $_formulas:=WP Get formulas(WriteProArea)

 

  // query the collection from WP Get formulas

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

 

  // then replace each formula

 For each($formula;$_formulas)

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

 End for each

Siehe auch

Formeln verwalten
WP COMPUTE FORMULAS
WP FREEZE FORMULAS
WP Get formulas