f$Visio: MarkierteNamen (SelectionNames)
f$Visio: MarkierteNamen (engl.: SelectionNames)
Mit dieser Funktion werden die Namen aller derzeit markierten Shapes ausgelesen. Die aktuell markierte Anzahl von Shapes kann über MarkierteAnzahl ermittelt werden.
Über die Programmschnittstelle werden mit der Funktion Shape bzw. ShapeHinzu Shapes bzw. Gruppierungen markiert, allerdings kann der Anwender auch interaktiv Shapes markieren.
Bitte beachten: Der Parametername für den Funktionswert, der in FeldName übergeben wird, wird indirekt in einer Zeichenkette übergeben, also in Anführungszeichen eingeschlossen. Außerdem muss er global und als einfach indiziertes Feld ausreichender Größe definiert sein. Die Feldgröße kann ohne Auswirkungen auf die Performance großzügig bemessen werden.
Parameter für f$visio:
Parameter | Wert | Bedeutung |
Kennung | 'Visio' | Schlüsselwort |
Eigenschaft | 'MarkierteNamen' | Schlüsselwort |
Wert | '' | Name eines indizierten globalen Parameters vom Typ Zeichenkette, der nach dem Aufruf die Shapenamen enthält; die Angabe erfolgt ohne Index. Das Listenende ist durch einen Parameterwert LEER gekennzeichnet. |
Ergebnis: | Ganzzahl | Status: 0 – alles OK, sonst siehe Rückgabestatus Rückgabewerte der Funktionen (Visio) |
Beispiel: | Status = f$visio( 'Visio', 'MarkierteNamen', 'Namensliste' ) → Namensliste[1] = 'Pumpe' | |