ComputeLengthOfElement [CAL]

Mit ComputeLengthOfElement wird die Länge eines String-Elements oder eines Teilbereiches des String-Elements zwischen zwei gegebenen Punkten berechnet. Entweder können Punkthandles mit Parametern übergeben werden oder zwei Punkte des String-Elementes werden im Dialog identifiziert und die Länge von Punkt1 bis Punkt2 wird berechnet. Ebenso kann die Gesamtlänge des geöffneten Elements berechnet werden.

Über Funktionsparameter kann die Funktion weiter automatisiert und gesteuert werden (alle Parameter sind nicht case-sensitiv). Bei Verwendung des Parameters STARTPOINT/ zusammen mit dem Parameter ENDPOINT/ entfällt das bei einigen Modi sonst notwendige identifizieren der zwei Punkte.

Der Parameter legt den Modus der Funktion fest, d.h es existieren einige vordefinierte Einstellungen für die Auswahl der String-Elemente, der Attributspeicherung und die grafische Anzeige.

Die Angabe des Parameters ist optional und erfolgt in der Form QTX/n, wobei n die Werte 0-9 mit folgenden Bedeutungen annehmen kann:

0: Zwei Punkte müssen identifiziert werden und die Länge von Punkt1 bis Punkt 2 wird unter dem mit dem Parameter LBL angegebenen Attributnamen abgespeichert und im Dialogfenster angezeigt.

1: Die Länge des identifizierten String-Elements wird unter dem mit dem Parameter LBL angegebenen Attributnamen abgespeichert und im Dialogfenster angezeigt.

2: Die Längen der jeweils ersten String-Elemente aller selektierten Objekte werden unter dem mit dem Parameter LBL angegebenen Attributnamen abgespeichert.

3: Die Längen der jeweils ersten String-Elemente aller selektierten Objekte werden unter dem mit dem Parameter LBL angegebenen Attributnamen abgespeichert und im Dialogfenster angezeigt.

4: Die Längen der jeweils ersten String-Elemente aller selektierten Objekte werden unter dem mit dem Parameter LBL angegebenen Attributnamen abgespeichert und im Dialogfenster angezeigt und grafisch markiert.

5: Zwei Punkte müssen identifiziert werden und die Länge von Punkt1 bis Punkt 2 wird im Dialogfenster angezeigt.

6: Die Länge des identifizierten String-Elements wird im Dialogfenster angezeigt.

7: Die Länge des identifizierten String-Elements wird zum Rückgabewert der Funktion.

8: Die Länge des ersten String-Elements des identifizierten Objekts wird unter dem mit dem Parameter LBL angegebenen Attributnamen abgespeichert und im Dialogfenster angezeigt.

9: Zwei Punkte müssen identifiziert werden und die Länge von Punkt1 bis Punkt 2 wird unter dem mit dem Parameter LBL angegebenen Attributnamen abgespeichert, zum Rückgabewert der Funktion und im Dialogfenster angezeigt.

Wird der Parameter nicht mit angegeben, so wird automatisch die Einstellung QTX/5 ausgeführt.

Es wird der Attributname, unter dem der Längenwert abgespeichert werden soll, festgelegt.

Die Eingabe erfolgt in der Form LBL/x, wobei für x drei alphanumerische Zeichen angegeben werden können.

Der Parameter ist optional und macht nur im Zusammenhang mit der Eingabe des Parameters QTX einen Sinn - seine Voreinstellung ist „LNG“.

Es wird die Anzahl der Nachkommastellen – und damit die Genauigkeit – bei der Angabe des Längenwerts festgelegt.

Die Eingabe erfolgt in der Form TYP/n, wobei für n nur die Werte zwischen 1 und 5 (einschließlich) zugelassen sind.

Der Parameter wirkt nur im Parametermodus QTX/0 oder 5 oder 9. Hierfür macht er das ausgewählte String-Element zum aktuellen Element.

Das Handle des Startpunkts für die Berechnung der Länge. Der Parameter ist optional.

Das Handle des Endpunkts für die Berechnung der Länge. Der Parameter ist optional.

Es wird eine Hilfe für die Funktion ComputeLengthOfElement gegeben. Der Hilfstext enthält eine kurze Beschreibung der Funktion sowie eine Aufrufanleitung.

Die Angabe des Parameters ist optional und erfolgt in der Form -H oder /H (äquivalente Eingaben).

Wert	Beschreibung
0	Aufruf wurde erfolgreich durchgeführt
sonst	Fehler aufgetreten

Abfrage, wie bei der Abspeicherung des Längenwerts weiter verfahren werden soll, falls diese Option gewählt wurde und der ausgewählte Attributname schon belegt ist. <P,CLS,CON>

Der Dialog kann jederzeit über die Eingabe von CON verlassen werden. Es findet dann keine Längenberechnung statt.

Wird eine unerlaubte Eingabe gemacht so wird eine Fehlermeldung veranlaßt und der Dialog wird entweder wiederholt oder ganz verlassen.

Länge eines Teil-String-Elementes auf zwei Stellen genau berechnen, unter dem Attributnamen „Elvis“ abspeichern und im Dialogfenster anzeigen lassen

Länge eines String-Elementes auf drei Stellen genau berechnen, unter dem Attributnamen „Elvis“ abspeichern und im Dialogfenster anzeigen lassen. Da der gewählte Attributnamen schon einen Wert besitzt, soll er überschrieben werden

Länge der String-Elemente aller selektierten Objekte auf acht Stellen genau berechnen und jeweils unter dem Attributnamen „Marilyn“ abspeichern

Länge der String-Elemente aller selektierten Objekte auf acht Stellen genau berechnen, jeweils unter dem Attributnamen „Marilyn“ abspeichern und im Dialogfenster anzeigen

Länge der String-Elemente aller selektierten Objekte auf acht Stellen genau berechnen, jeweils unter dem Attributnamen „Marilyn“ abspeichern, im Dialogfenster anzeigen und alle bearbeiteden String-Elemente grafisch markieren

Enthält das identifizierte String-Element isolierte Punkte (P-Verbindungen), so wird die Strecke zu diesen bei der Längenberechnung ignoriert, d.h. sie besitzen keine Länge.