SelectObjectsInPolygon [SLA]

Top  Previous  Next

Diese Funktion selektiert und deselektiert Objekte. Als Default arbeitet sie auf den Objekten der Selektionsmenge. Die Funktion fragt im Dialog nach einem Polygon. Dieses Polygon ist vom Benutzer zu digitalisieren, es wird dabei immer von #L-Verbindungen ausgegangen. Das Polygon darf sich nicht selbst schneiden, deshalb wird der Benutzer gefragt, ob das Polygon in Ordnung ist. Wird das Polygon akzeptiert, dann wird die Selektion gestartet. Wird das Polygon verworfen, kann ein neues digitalisiert werden. Der Benutzer hat auch die Möglichkeit, die Funktion komplett abzubrechen.

Wird das Polygon akzeptiert, wird eine Selektionsprozedur gestartet. Dabei kann über den Parameter SEL/ angegeben werden, welche Objekte selektiert oder deselektiert werden sollen.

Voraussetzung

Die Datenbank muß geöffnet sein.

Eine Ebene muß geöffnet sein.

Parameter

SEL/<str>

Mit diesem Parameter wird die Selektionsfunktion bestimmt. Die Zeichenkette <str> kann dazu folgende Worte beinhalten:

IN um Objekte zu selektieren, die innerhalb des Polygons liegen.

OUT um Objekte zu selektieren, die außerhalb des Polygons liegen.

PART um Objekte zu selektieren, die inner- und außerhalb des Polygons liegen.

Die Worte müssen durch Kommata getrennt und ohne Leerzeichen hintereinander geschrieben werden.

/IDENTIFY

Bei Verwendung dieses Schalters wird das geöffnete Polygon zum selektieren benutzt.  Ist kein Stringelement geöffnet, wird eine Fehlermeldung ausgegeben.

SRC/PTR_xxx

Bei Verwendung dieses Schalters wird das Element mit dem Handle PTR_xxx als Polygon zum selektieren benutzt. Ist es kein Stringelement, wird eine Fehlermeldung ausgegeben.

/IOR

Die von der Funktion selektierte Objekte werden zur Selektionsmenge hinzugefügt.

/XOR

Die von der Funktion selektierte Objekte werden zur Selektionsmenge hinzugefügt, wenn sie noch nicht in ihr enthalten sind, sonst werden sie aus ihr entfernt.

/RETURN

Die Handles der von der Funktion selektierten Objekte werden zurückgegeben, anstatt die Selektionsmenge zu ändern.

/NEW

Die Funktion arbeitet auf den selektierten und selektierbaren Objekten aller aktiven Pläne.

/ALL_PLANS

Die Funktion arbeitet auf allen Objekten, auch in ausgeschalteten Plänen.

SEG/n1,n2,...

Der Schalter schränkt die Menge der zu bearbeitenden Objekte auf die aus Segmenten in der Liste ein. Er kann mit anderen kombiniert werden, insbesondere mit /NEW oder /ALL_PLANS.

/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

Sollen zum Beispiel nur innen liegende Objekte selektiert werden, ist als Parameter:

SelectObjectsInPolygon SEL/IN

anzugeben, alle Objekte, die nur teilweise oder ganz außerhalb des Polygons liegen, werden deselektiert und nicht mehr angezeigt. Um alle Objekte zu selektieren die teilweise oder außerhalb des Polygons liegen, muß

SelectObjectsInPolygon SEL/OUT,PART oder

SelectObjectsInPolygon SEL/PART,OUT

angegeben werden.

Bei der Angabe von

SelectObjectsInPolygon SEL/IN,PART,OUT

werden erwartungsgemäß alle Objekte selektiert. Wird der Parameter nicht angegeben, werden die Objekte innerhalb des Polygons selektiert.

Bemerkung

Siehe auch

DeleteObjectsInPolygon [DLA]

ShiftArea [SAR]

Select [SEL]

FindByAttributes [FND]