ConcatSections

Top  Previous  Next

 

Verkettet zusammenpassende Stringelemente eines Objekts.

Stringelemente mit übereinstimmendem DKY und DKA und Enden mit identischen Koordinaten werden an diesen Enden zusammengehängt. Dabei können Ketten aus beliebig vielen Stringelementen entstehen. Der Begriff Ende bezeichnet in diesem Zusammenhang sowohl die Anfangs- als auch die Endpunkte der Stringelemente.

Besitzen mehr als zwei Stringelemente ein Ende im gleichen Punkt, so ist es Zufall, welche von ihnen miteinander verkettet werden.

Voraussetzung

Wenn der Parameter SELECTIONLIST nicht angegeben ist, dann muß ein Objekt eröffnet sein.

Parameter

/SELECTIONLIST

Die Objekte der Selektionsmenge werden bearbeitet. Es können nur diejenigen Stringelemente miteinander verkettet werden, die jeweils zum gleichen Objekt gehören.

Rückgabewert

Wert

Beschreibung

0

Aufruf wurde erfolgreich durchgeführt

sonst

Fehler aufgetreten

Dialog

Kein Objekt geöffnet

ConcatSections wurde ohne Schalter /SELECTIONLIST und ohne geöffnetes Objekt aufgerufen. Die Funktion wird nach dieser Meldung wirkungslos beendet.

Beim Verketten von Strings ist ein Fehler aufgetreten.

Bei der Bearbeitung eines Objekts ist ein Fehler aufgetreten.

Beispiel

ConcatSections

ConcatSections /SELECTIONLIST

Bemerkung

Wenn bei der Verkettung der Stringelemente eines Objekts ein Fehler aufgetreten ist, dann wird die Bearbeitung dieses Objekts abgebrochen, bereits durchgeführte Verkettungen in diesem Objekt werden aber nicht rückgängig gemacht. Wurde die Funktion mit dem Parameter /SELECTIONLIST aufgerufen, dann wird mit dem nächsten Element der Liste fortgefahren. Die diesbezügliche Fehlermeldung erfolgt nur einmal, auch wenn bei weiteren Objekten Fehler auftreten.

Siehe auch

ConcatString