Die Funktion esri_featurelayer_selectspecial gibt basierend auf besonderen Kriterien einen AutoCAD-Auswahlsatz von einem angegebenen Feature-Layer zurück. Diese Funktion ist nützlich für die Qualitätssicherung und die Compliance-Prüfung vor der Synchronisierung von Web-Feature-Layern oder für die Suche von Objekten basierend auf verschiedenen Bearbeitungs- und Datenzuständen, wenn mit Feature-Layern gearbeitet wird.
Folgende besondere Suchkriterien sind möglich:
- FlaggedAsModified: AutoCAD-Objekte, die als Features des angegebenen Web-Feature-Layers geeignet sind und deren Bearbeitungsstatus als geändert gekennzeichnet ist.
- FlaggedAsNew: AutoCAD-Objekte, die als Features des angegebenen Web-Feature-Layers geeignet sind und deren Bearbeitungsstatus als ein neues Feature gekennzeichnet ist.
- IncorrectGeometry: AutoCAD-Objekte, die aufgrund des AutoCAD-Layers, auf dem sie sich befinden, als Features geeignet wären, aber nicht als Features gelten, da sie den falschen Geometrietyp aufweisen. Ein Beispiel sind Polylinien, die auf einem AutoCAD-Layer von ArcGIS-Punkt-Features gezeichnet werden.
- OutsideProjectArea: AutoCAD-Objekte, die Features des angegebenen Feature-Layers sind und die sich außerhalb der Grenze des aktuellen Projektbereichs befinden.
- ProxyObjectPresent: AutoCAD-Proxy-Objekte, die verwendet werden, um eine benutzerdefinierte Objektgeometrie darzustellen, wie z. B. Koordinatenpunkte außerhalb von AutoCAD Civil 3D, oder wenn kein Objekt-Enabler vorhanden ist.
- UnclosedPolylines: AutoCAD-Polylinien-Objekte, die als Polygon-Features geeignet wären, bei denen das Kennzeichen für eine geschlossene Polylinie aber nicht für das Objekt festgelegt ist.
Hinweis:
Es wird nicht empfohlen, eine große Anzahl von Auswahlsätzen gleichzeitig zu verwalten. Eine Anwendung kann maximal 128 festgelegte Auswahlsätze gleichzeitig geöffnet haben. (Auf Ihrem System kann die Grenze niedriger sein.) Wenn die Grenze erreicht ist, erstellt AutoCAD keine weiteren Auswahlsätze. Halten Sie jeweils nur eine minimale Anzahl von Sätzen offen, und legen Sie für nicht benötigte Auswahlsätze den Wert nil so schnell wie möglich fest. Wenn die maximale Anzahl an Auswahlsätzen erreicht ist, können Sie keine weiteren mehr erstellen.
Syntax
(esri_featurelayer_selectspecial flname select_settings)
Argumente
- flname | Zeichenfolge | erforderlich | Ein vorhandener Web-Feature-Layer- oder Dokument-Feature-Layer-Name in der Zeichnung.
- select_settings | Assoziationsliste | erforderlich | Eine Assoziationsliste von Auswahleinstellungen.
| Assoziierte Bezeichnung | Wertetyp | Wertbeschreibung | Erforderlich oder optional |
|---|---|---|---|
| "CRITERIA" | string | Die Suchkriterien. Gültige Wert sind "UnclosedPolyline" und "IncorrectGeometry", "ProxyObjectPresent". Optionen, die nur für Web-Feature-Layer gelten, sind "FlaggedAsModified", "FlaggedAsNew" und "OutsideProjectArea". | Erforderlich |
| "SUBTYPE" | Zeichenfolge | Der Subtype-Name als Zeichenfolge. Verwenden Sie die leere Zeichenfolge "", um alle Subtypes aufzunehmen. | Optional |
Beispiel 1 für die Verwendung
Erstellen eines Auswahlsatzes aller Objekte, die zum Feature-Layer shelters gehören und außerhalb des Projektbereichs der aktuellen Zeichnung liegen.(esri_featurelayer_selectspecial "shelters"
(list (cons "CRITERIA" "OutsideProjectArea"))
)
Ergebnis des Beispiels 1 für die Verwendung
Ein Auswahlsatz aller Objekte, die zum Feature-Layer shelters gehören und außerhalb des Projektbereichs der aktuellen Zeichnung liegen:
<Selection set: 9f>Beispiel 2 für die Verwendung
Erstellen eines Auswahlsatzes aller Objekte, die zum Subtype Public des Web-Feature-Layers Roads gehören und von denen ArcGIS for AutoCAD annimmt, dass sie geändert wurden, bevor eine Synchronisierung in der aktuellen Zeichnung erfolgt ist:(esri_featurelayer_selectspecial "Roads"
(list (cons "CRITERIA" "FlaggedAsModified")(cons "Subtype" "Public"))
)
Ergebnis des Beispiels 2 für die Verwendung
Gibt einen Auswahlsatz aller Objekte zurück, die zum Subtype Public des Web-Feature-Layers Roads gehören und von denen ArcGIS for AutoCAD annimmt, dass sie geändert wurden, bevor eine Synchronisierung in der aktuellen Zeichnung erfolgt ist:
<Selection set: d0>Rückgabewerte
Folgende Werte sind mögliche Rückgabewerte:
- Gibt bei erfolgreicher Ausführung ein AutoCAD-Auswahlsatzobjekt zurück.
- Wenn bei dem Vorgang ein Fehler auftritt, wird eine Liste zurückgegeben, in der der erste Wert nil lautet. Anschließend wird eine Assoziationsliste mit dem Schlüsselwert "Error" sowie eine entsprechende Fehlermeldung in Form einer Zeichenfolge zurückgegeben: (nil ("Error" . "<message>")).
Rückgabewerte mit Fehlern
Ein Rückgabewert mit einem Fehler kann eine der folgenden Ursachen haben:
- (nil ("Error" . "Missing required argument."))
Mindestens eines der erforderlichen Argumente wurde nicht angegeben.
- (nil ("Error" . "Feature layer not found."))
Der erforderliche Feature-Layer-Wert ist ungültig oder fehlt.
- (nil ("Error" . "Subtype name does not exist."))
Der erforderliche subtype-Name ist ungültig oder fehlt.