f$Visio: DokListeVollName (engl.: DocListFullName)

Lesen der Namen aller im Moment geladenen Zeichnungen. Die Namen werden als vollständige Dateinamen mit Pfadangabe und Dateierweiterung zurückgegeben.

Mit der Funktion DokAktivieren kann eine Zeichnung aus dieser Liste zur aktiven Zeichnung gemacht werden (siehe Beispiel dort).

Eine Liste der reinen Zeichnungsnamen ohne Pfadangabe kann über die Funktion DokListeName ermittelt werden, nur die Zeichnungspfadnamen erhält man mit DokListeVerz. Den Namen des aktiven Zeichnungsdokuments erhält man über DokAktivName, DokAktivVollName bzw. DokAktivVerz gelesen werden.

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 Zeichenketten-Feld definiert sein!

Der Feldparameter für die Zeichnungsnamen muss ausreichend dimensioniert sein, die Feldgröße kann allerdings ohne Auswirkungen auf die Performance großzügig bemessen werden. Vor dem Aufruf der Funktion kann die aktuelle Anzahl geladener Zeichnungen auch über DokAnzahl abgefragt werden.

Hinweis: Wenn die Pfadangabe im Zeichnungsnamen fehlt, wurde die Zeichnung neu angelegt und noch nicht gespeichert.

Parameter für f$visio:

Parameter	Wert	Bedeutung
Kennung	'Visio'	Schlüsselwort
Eigenschaft	'DokListeVollName'	Schlüsselwort
Wert	FeldName	Name eines globalen Parameterfeldes vom Typ Zeichenkette, der nach dem Aufruf die Namen aller geladenen Zeichnungen enthält. Die Liste wird durch ein Feldelement im Zustand LEER abgeschlossen
Ergebnis:	Ganzzahl	Status: 0 – alles OK, sonst siehe Rückgabestatus Rückgabewerte der Funktionen (Visio)
Beispiel:	Status = f$visio( 'Visio', 'DokListeVollName', 'Namensliste' ) → Namensliste[1] = 'c:\\Visio\\Zeichnung1.vsd' Namensliste[2] = 'Zeichnung2.vsd' Namensliste[3] ist LEER