f$Visio: ShapeEin (engl.: ShapeIn)

Einfügen eines neuen Shapes aus einer Schablone in die Zeichnung. Die Einfügeposition ist der Nullpunkt, also die Koordinate 0/0.

Das Shape wird nach dem Einfügen automatisch zum aktiven Shape, kann also z.B. direkt auf die richtige Position verschoben werden.

Das neue Shape wird zunächst in der aktiven Schablone gesucht. Ist es dort nicht vorhanden, werden alle mit dem aktiven Dokument verbundenen Schablonen nach dem Shape durchsucht. Wird es dort gefunden, wird diese Schablone automatisch zur aktiven Schablone, ansonsten bleibt die ursprüngliche Schablone aktiv und es erscheint eine Fehlermeldung.

Wenn mehrere gleiche Shapes in die Zeichnung eingefügt werden, sollten sie am besten gleich beim Einfügen mit einem neuen Namen versehen werden (Kommando SetzeName), damit sie später individuell über das Kommando Shape aktiviert werden können. Alternativ kann der von Visio vergebene Name auch mit dem Kommando LeseName ausgelesen werden, um das Shape später wieder ansprechen zu können (Visio vergibt bei mehrdeutigen Namen zusätzlich eine durch „." abgetrennte ID-Nummer, z.B. „Rechteck.38").

Parameter für f$visio:

Parameter	Wert	Bedeutung
Kennung	'Visio'	Schlüsselwort
Eigenschaft	'ShapeEin'	Schlüsselwort
Wert	Shapename	Name des einzufügenden Shapes, wie er auch in der Schablone angezeigt wird
Ergebnis:	Ganzzahl	Status: 0 – alles OK, sonst siehe Rückgabestatus Rückgabewerte der Funktionen (Visio)
Beispiel:	Einfügen eines abgerundeten Rechtecks in die aktuelle Zeichnung (am Nullpunkt): Status = f$visio( 'Visio', 'ShapeEin', 'Abgerundetes Rechteck' ) ... und Verschieben des Rechtecks auf die zuvor in den Parametern x und y berechnete Position: Status = f$visio( 'Formel', 'DrehPktX', f$FormatZahl( x, '#' ) +' mm' ) Status = f$visio( 'Formel', 'DrehPktY', f$FormatZahl( y, '#' ) +' mm' )