f$Visio: FormelWert (FormulaValue)

f$Visio: FormelWert (engl.: FormulaValue)

Lesen eines Formelwertes bzw. einer Shapesheet-Eigenschaft für das aktive Shape. Zurückgeliefert wird der ausgerechnete Formelwert. Ist dagegen der Formeltext selbst von Interesse, kann die Funktion FormelInhalt verwendet werden.

Mit dem Kommando Formel können die Shapesheet-Eigenschaften gesetzt werden. Die Werte für die gesamte Zeichnung können mit SeitenFormel gesetzt bzw. mit SeitenFormelWert gelesen werden.

Die wichtigsten Shapesheet-Eigenschaften sind:

Deutsch	Englisch	Bedeutung
DrehpktX	PinX	Bezugskoordinate in x des Shapes für Position und Drehwinkel
DrehpktY	PinY	Bezugskoordinate in y des Shapes für Position und Drehwinkel
Breite	Width	Breite des Shape (horizontale Ausdehnung)
Höhe	Height	Höhe des Shape (vertikale Ausdehnung)
Winkel	Angle	Drehwinkel (mathematisch positiv, d.h. gegen den Uhrzeiger)

Für den Fall, dass die Logik auch einmal auf einem PC mit einer anders sprachigen Version von Visio laufen könnte, sollten die englischen Bezeichnungen verwendet werden, da diese von jeder Programmversion von Visio verstanden werden. Eine Liste der gebräuchlichsten Zellbezeichnungen findet sich im Abschnitt unterschiedliche Systemsprachen.

Wenn der aktuelle Formelwert nur aus Ziffern, Punkt und Komma besteht, wird der Wert automatisch als Zahl zurückgegeben. Wird dies nicht gewünscht, z.B. bei einer Positionsnummer "10.20", kann statt FormelWert FormelWertZ verwendet werden.

Bei Abmessungen richtet sich die Rückgabe der Maßeinheit nach der Form der Anlage (Speicherung) des Wertes. Wurde beim Setzen des Wertes eine Einheit mit angegeben, so ist sie auch im Rückgabewert enthalten. Wurde dagegen keine Maßeinheit angegeben, so gilt bei Setzen und Lesen die über das Kommando Einheit festgelegte Einheit. Wenn die Standardeinheit geändert wird, werden alle Werte in der Standardeinheit automatisch umgerechnet.

Bitte beachten: Der Parametername für den Funktionswert, der in ParaName übergeben wird, wird indirekt in einer Zeichenkette übergeben, also in Anführungszeichen eingeschlossen. Außerdem muss er global sein!

Parameter für f$visio:

Parameter	Wert	Bedeutung
Kennung	'FormelWert'	Schlüsselwort
Eigenschaft	Name	Name der Shapesheet-Eigenschaft. Es sind alle Werte der Tabelle möglich
Wert	ParaName	Name eines globalen Parameters vom Typ Zeichenkette, der nach dem Aufruf die gelesene Einstellung enthält. Bei Abmessungen wird die Einheit u.U. mit angegeben (s.o.).
Ergebnis:	Ganzzahl	Status: 0 – alles OK, sonst siehe Rückgabestatus Rückgabewerte der Funktionen (Visio)
Beispiel:	Setzen der Position des aktiven Shapes nach Festlegung der Standardeinheit auf „mm": Status = f$visio( 'Visio', 'Einheit', 'mm' ) Status = f$visio( 'Formel', 'DrehpktX', '50' ) Status = f$visio( 'Formel', 'Drehpkty', '10 cm' ) Umsetzen der Standardeinheit auf „m", Auslesen der gesetzten Werte: Status = f$visio( 'Visio', 'Einheit', 'm' ) Status = f$visio( 'FormelWert', 'DrehpktX', 'x' ) → x = '0,05' (50mm = 0,05m; Die Standardeinheit wird automatisch umgerechnet.) Status = f$visio( 'FormelWert', 'Drehpkty', 'y' ) → y = '10 cm' (Der Wert wurde mit der Einheit gespeichert.)