f$Visio: SetzeName (engl.: SetName)

Setzen eines neuen Namens für das aktive Shape.

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 (z.B. über das Kommando Shape), muss dieser Name angegeben werden.

Bei einer Gruppierung von Shapes wird immer ein neuer Systemname für die Gruppe vergeben (z.B. "Sheet.3"). Dieser Name kann ebenfalls über SetzeName geändert werden.

Tipp: Statt immer einen neuen Shapenamen zu definieren, kann nach dem Einfügen der Name des aktiven Shapes auch ausgelesen werden (Kommando LeseName) und in einem ePOS-Parameter zwischengespeichert werden.

Parameter für f$visio:

Parameter	Wert	Bedeutung
Kennung	'Visio'	Schlüsselwort
Eigenschaft	'SetzeName'	Schlüsselwort
Wert	Shapename	neuer Name des aktiven Shapes (max. 31 Zeichen). Wenn schon ein Shape dieses Namens vorhanden ist, wird der Name automatisch um eine ID-Nummer ergänzt (z.B. "MeinShape.18").
Ergebnis:	Ganzzahl	Status: 0 – alles OK, sonst siehe Rückgabestatus Rückgabewerte der Funktionen (Visio)
Beispiel:	Status = f$visio( 'Visio', 'SetzeName', 'Pumpe' ) → das aktive Shape heißt jetzt "Pumpe"