WP Get formulas

Home

4D v20 R7

WP Get formulas


WP Get formulas ( targetObj ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
targetObj	Objekt	Range oder Element oder 4D Write Pro Dokument
Funktionsergebnis	Collection	Collection der Formeln

Beschreibung

Der Befehl WP Get formulas gibt eine Collection mit allen Formeln zurück, die in targetObj definiert sind.

Im Parameter targetObj übergeben Sie:

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

Hinweis: Wenn Sie einen Abschnitt in targetObj übergeben, werden nur Bildformeln oder Formeln in Textfeldern zurückgegeben, die in diesem Abschnitt oder allen Abschnitten verankert sind. Wenn sie auf einer Seite oder in der eingebetteten Ansicht verankert sind, werden ihre Formeln nicht zurückgegeben. Übergeben Sie das Dokument in targetObj, um alle Formeln für verankerte Elemente zu erhalten.

Zurückgegebener Wert

WP Get formulas gibt eine Collection der Objekte Formel zurück, wobei jede Formel eine oder mehrere Eigenschaften haben kann:

Eigenschaft	Typ	Beschreibung
[ ].formula	Objekt	Der String der Formel ist über [ ].formula.source verfügbar. Die Formel ist eine Kopie der Formel aus dem Ziel. Wollen Sie die Formel verändern, müssen Sie diese erneut in das Dokument einfügen, damit sie berücksichtigt wird.
[ ].range	Objekt	Range der Formel (wird nicht für Formeln für verankerte Bilder zurückgegeben)
[ ].anchoredID	Text	ID des verankerten Bildes (wird nur für Formeln für verankerte Bilder zurückgegeben)
[ ].name	Text	Name des Formulars, wenn ein Name definiert wurde (sonst nicht zurückgegeben). Namen können mit WP INSERT FORMULA definiert werden.
[ ].owner	Objekt	4D Write Pro Dokument

Hinweise:

Ist als Ziel ein Unterabschnitt übergeben, werden Formeln des übergeordneten Abschnitts zurückgegeben.
Werden mehrere Formeln zurückgegeben, wird die Collection nach der Reihenfolge der Formeln im Ziel sortiert, außer für Ziele vom Typ Dokument und Abschnitt (hier ist die Reihenfolge beliebig).

Beispiel

Alle Formeln in einem Dokument erhalten:

 C_COLLECTION($formulas)

 $formulas:=WP Get formulas(WriteProArea)

Alle Formeln im ersten Abschnitt eines Dokuments erhalten:

 C_COLLECTION($formulas)

 $formulas:=WP Get formulas(WP Get section(WriteProArea;1))

Die Formeln aller verankerten Bilder in einem Dokument erhalten:

 C_COLLECTION($formulas)

 $formulas:=WP Get formulas(WriteProArea).query("anchoredID # null")

Siehe auch

Formeln verwalten
WP COMPUTE FORMULAS
WP FREEZE FORMULAS
WP Get links
WP INSERT FORMULA