f$Visio: SeitenFormelWert (engl.: PageFormulaValue)
f$Visio: SeitenFormelWert (engl.: PageFormulaValue)
Lesen von Einstellungen für die aktuelle Seite (das Zeichnungsblatt). Mit dem Kommando SeitenFormel können die Einstellungen auch geändert werden.
In Microsoft Office Visio können die Einstellungen der Seite mit dem Kommando „Shapesheet anzeigen" bearbeitet werden (Bei Ausführung des interaktiven Visio-Kommandos darf allerdings kein Shape markiert sein, da ansonsten das Shapesheet des markierten Shapes dargestellt wird.). In dieser Schnittstelle können alle Werte aus dem angezeigten Dialog manipuliert werden, wobei die angezeigten Eigenschaftsnamen der Funktion als Formelname übergeben werden.
Die wichtigsten Shapesheet-Eigenschaften der Seite sind:
Deutsch | Englisch | Bezeichung |
BlattBreite | PageWidth | Breite des Zeichnungsblattes, z.B. ’210 mm’ für DIN-A4 Hochkant |
BlattHöhe | PageHeight | Höhe des Zeichnungsblattes, z.B. ’297 mm’ für DIN-A4 Hochkant |
BlattMaßstab | PageScale | Maßstabsangabe für das Zeichnungsblatt (z.B. ’1 cm’ auf dem Papier bzw. Bildschirm) |
ZeichMaßstab | DrawingScale | Maßstabsangabe für die Zeichnung (z.B. ’10 m’). Mit einem BlattMaßstab von ’1 cm’ ergibt sich dann ein Maßstab von 1:1000 |
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.
Die zurückgegebenen Abmessungen enthalten entweder direkt eine Maßeinheit oder es gilt die zuletzt über das Kommando Einheit eingestellte Einheit. Sollen die Werte also in einer bestimmten Maßeinheit zurückgegeben werden, kann diese zuvor gesetzt werden.
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 | 'SeitenFormelWert' | 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: | Lesen der Größe des Zeichnungsblattes (in mm): Status = f$visio( 'Visio', 'Einheit', 'mm' ) → Höhe = '210 mm', Breite = '297 mm' | |