JoinObjects

Top  Previous  Next

Fügt mehrere Objekte an Hand eines gemeinsamen Attributs zusammen. Es werden alle graphischen Elemente in ein Objekt zusamengeführt.

Dabei gibt es drei Möglichkeiten:

1.  Alle Objekte mit gleichem Attributwert werden zusammengeführt: Nur SRCKEY und SRCQTX müssen angegeben werden.

2.  Objekte vom Typ 1 werden in Objekte vom Typ 2 eingefügt: auch DESTKEY und DESTQTX müssen angegeben werden.

3.  Sowohl Ziel-als auch Quellobjekt haben keine Verbindung, können aber über ein weiters Objekt miteinander in Verbindung gebracht werden: JOINKEY, JOINSRCQTX, JONDESTQTX sind erforderlich.

Voraussetzung

Ein Objekt muß geöffnet sein.

Parameter

SRCKEY/<nn>

Schlüssel der Objekte, die zusammengefügt werden sollen. Es kann eine Liste mit Kommata oder  in der Form a-m,n-z angegeben werden.

SRCQTX/<ccc>

Attribut anhand dessen die Objekte zusammengeführt werden sollen

DESTKEY/<nn>

Schlüssel des Zielobjekts, in das die SRC-Objekte überführt werden sollen

DESTQTX/<ccc>

Attribut des Zielobjekts, dessen Wert dem Attributwert des SRC-Objekts entspricht.

JOINKEY/<nn>

Schlüssel des Objekts, das einen Attributihnalt mit dem SRC-Objekt und einen mit dem Zielobjekt gemeinsam hat.

JOINSRCQTX/<ccc>

Attribut des Join-Objekts, dessen Wert dem Attributwert des SRC-Objekts entspricht.

JOINDESTQTX/<ccc>

Attribut des Join-Objekts, dessen Wert dem Attributwert des DEST-Objekts entspricht.

/srcQTXisPart

Mit diesem Schalter werden im DESTQTX auch Listen von Attributwerten erkannt. Als Trenner sind Leezeichen, Komma und Zeilenumbrüche zulässig.

/H

Mit diesem Schalter wird ein Hilfetext und die Aufrufkonvention angezeigt.

 

Rückgabewert

Wert

Beschreibung

0

Aufruf wurde erfolgreich durchgeführt

sonst

Fehler aufgetreten

Dialog

Beispiel

Bemerkung

Siehe auch