f$Visio: LeseName (GetName)
f$Visio: LeseName (engl.: GetName)
Lesen des Namens für das aktive Shape bzw. die aktive Gruppierung.
Nach dem Einfügen eines neuen Shapes erhält es den Namen des Mastershapes aus der Schablone. Da der Shapename aber immer eindeutig sein muss, wird er automatisch um einen Punkt und eine ID-Nummer ergänzt, wenn schon ein Shape dieses Namens vorhanden ist (bei dem Shape „Rechteck" z.B. "Rechteck.25"). Wenn dieses Shape bei einer späteren erneuten Bearbeitung wieder aktiviert werden soll (Kommando Shape), muss dieser Name angegeben werden.
Für eine generelle Zeichnungsbearbeitung können auch die kompletten Shapes der Zeichnung ausgelesen werden (siehe LeseAlleNamen).
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 | 'Visio' | Schlüsselwort |
Eigenschaft | 'LeseName' | Schlüsselwort |
Wert | ParaName | Name eines globalen Parameters vom Typ Zeichenkette, der nach dem Aufruf den Shapenamen enthält. |
Ergebnis: | Ganzzahl | Status: 0 – alles OK, sonst siehe Rückgabestatus Rückgabewerte der Funktionen (Visio) |
Beispiel: | Status = f$visio( 'Visio', 'LeseName', 'ShapeName' ) → ShapeName = 'Pumpe' | |