f$Visio: ShapeAnzFilter (engl.: ShapeCntFilter)

Ermitteln der Anzahl aller Shapes der Zeichnung, für die eine Eigenschaft (Visio-Zelle) einen bestimmten Wert hat. Die betreffenden Shapenamen in diesem Filter können über ShapeListeFilter ermittelt werden. Diese Funktion kann z.B. dazu verwendet werden, um zu überprüfen, ob das bei ShapeListeFilter übergebene Feld für die Shapenamen ausreichend dimensioniert ist.

Das Filterkriterium für die auszuwählenden Shapes wird in Form einer Zeichenkette angegeben. Der syntaktische Aufbau dieses Filters ist identisch zur Verwendung bei ShapeListeFilter, die Beschreibung findet sich ebenfalls dort.

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	'ShapeAnzFilter'	Schlüsselwort
Eigenschaft	Filter	Filtertext, nach dem die Shapes selektiert werden (s.o.) Bei Angabe eines leeren Textes ('') werden alle Shapes ausgewählt, bei einem Syntaxfehler (Zeichen „=" fehlt), ist das Resultat -1.
Wert	ParaName	Name eines globalen Parameters vom Typ Ganzzahl, Dezimal oder Zeichenkette, der nach dem Aufruf die Anzahl der gefilterten Shapes enthält.
Ergebnis:	Ganzzahl	Status: 0 – alles OK, sonst siehe Rückgabestatus Rückgabewerte der Funktionen (Visio)
Beispiel:	Status = f$visio( 'ShapeAnzFilter', 'Prop.PosNr="'+PosNr+'"', 'Anzahl' )