VP ADD FORMULA NAME

Home

4D v19

VP ADD FORMULA NAME


VP ADD FORMULA NAME ( vpAreaName ; vpFormula ; name {; options} )

Parameter	Typ	Beschreibung
vpAreaName	Text	Name des Formularobjekts 4D View Pro Area
vpFormula	Text	4D View Pro Formel
name	Text	Name der Formel
options	Objekt	Optionen der Formel mit Namen

Beschreibung

Der Befehl VP ADD FORMULA NAME erstellt oder ändert eine Formel mit Namen im aktuellen Dokument.

Hinweis: Mit diesem Befehl erstellte Formeln mit Namen werden mit dem Dokument gesichert.

In vpAreaName übergeben Sie den Namen des 4D View Pro Bereichs. Übergeben Sie einen ungültigen Namen, wird ein Fehler zurückgegeben.

In vpFormula übergeben Sie die gewünschte 4D View Pro Formel mit Namen. Weitere Informationen dazu finden Sie im Kapitel Formeln in 4D View Pro.

In name übergeben Sie den neuen Namen der Formel. Wird er bereits innerhalb dieser Reichweite verwendet, ersetzt der neue Name der Formel den vorhandenen. Sie können für verschiedene Reichweiten den gleichen Namen verwenden (siehe unten).

In options können Sie ein Objekt mit zusätzlichen Eigenschaften für die Optionen der Formel mit Namen übergeben. Es gibt folgende Eigenschaften:

Eigenschaft

Typ

Beschreibung

scope

Zahl

Reichweite der Formel. Sie können den Index des Arbeitsblattes (Nummerierung beginnt bei 0) oder folgende Konstanten verwenden:

Konstante	Wert	Kommentar
vk current sheet	-1	Bestimmt das aktuelle Arbeitsblatt des 4D View Pro Bereichs (Standard)
vk workbook	-2	Bestimmt das komplette Workbook des 4D View Pro Bereichs.

Hinweis: Die Reichweite bestimmt, ob ein Formelname lokal für ein bestimmtes Arbeitsblatt gilt (scope=Index des Blattes oder vk current sheet) oder global für das gesamte Workbook (scope=vk workbook).

baseRow

Zahl

(optional) Eigener Ausgangspunkt (Zellenzeile) für relative Referenzen in der Formel. Ohne Angabe verwenden relative Referenzen (0;0) als Ausgangspunkt. Mit Angabe ist baseColumn zwingend.

baseColumn

Zahl

(optional) Eigener Ausgangspunkt (Zellenspalte) für relative Referenzen in der Formel. Ohne Angabe verwenden relative Referenzen (0;0) als Ausgangspunkt. Mit Angabe ist baseRow zwingend.

comment

Text

Kommentar zur Formel mit Namen

Beispiel 1

VP ADD FORMULA NAME("ViewProArea";"SUM($A$1:$A$10)";"Total2")

Beispiel 2

Eine Formel mit Namen erstellen, die auf die zwei direkt darüberliegenden Zellen verweist.

  // Die Summe von A1 zu A2 berechnen

  //und die Formel einsetzen in baseRow=2 und baseColumn=0 (A3)

 VP ADD FORMULA NAME("vpArea";"SUM(A1:A2)";"sum2Above";New object("baseRow";2;"baseColumn";0))

  //dann lässt sie sich überall anwenden, hier in D5

Siehe auch

VP Get formula by name
VP Get names
Zellenreferenzen