Fügt der AutoCAD-Zeichnung eine Dokument-Feature-Layer-Definition hinzu.
Verwendung:
- Bei Weglassen der FEATURE_LAYER_PROPERTIES wird der Feature-Layer ohne einen Abfragefilter erstellt und der GEOMTYPE wird auf "Punkt" festgelegt.
- Ist der optionale Parameter LAYERFILTER angegeben, wird die Layer-Liste als QUERYFILTER verwendet.
- Sofern ein komplexerer Abfragefilter als eine Layer-Liste erforderlich ist, empfiehlt sich die Verwendung der Funktion esri_docfeaturelayer_setquery.
- Wenn der neue Feature-Layer-Name bereits vorhanden ist, wird der angegebene Name hinzugefügt, aber ihm wird eine fortlaufende Nummer angehängt.
Syntax
(esri_docfeaturelayer_add flname [featurelayer_properties])
Argumente
- flname | Zeichenfolge | erforderlich | Der neue Dokument-Feature-Layer-Name.
- featurelayer_properties | Assoziationsliste | optional | Die Eigenschaften des Feature-Layers.
Assoziierte Bezeichnung Wertetyp Wertbeschreibung Erforderlich oder optional "GEOMTYPE " Zeichenfolge
Der geometrische Typ des neuen Feature-Layers: {"Polygon", "Point", "Polyline", "Annotation" oder "Multipatch"}
optional (Point ist die Standardeinstellung.)
"LAYERFILTER" Zeichenfolge
Ein oder mehrere Namen von AutoCAD-Layern, durch Komma getrennt und zu einer einzigen Zeichenfolge zusammengefasst, die als QUERYFILTER für die neue Feature-Class dienen soll.
Hinweis:
- Der Standardwert ist "*" und bedeutet die Einbeziehung aller Layer.
- Verwenden Sie die Funktion esri_docfeaturelayer_setquery, wenn Sie einen komplexeren QUERYFILTER erstellen möchten.
Optional
Beispiel für die Verwendung
Versuchen Sie, ein Polylinien-Dokument-Feature namens ROADS hinzuzufügen, wobei sich die Objekte, die den Feature-Layer definieren, auf dem AutoCAD-Layer STREETS befinden:(esri_docfeaturelayer_add "ROADS"
(list
(cons "GEOMTYPE" "POLYLINE")
(cons "LAYERFILTER" "STREETS")
))
Ergebnis des Beispiels für die Verwendung
Fügt ein Polylinien-Dokument-Feature namens ROADS hinzu, wobei sich die Objekte, die den Feature-Layer definieren, auf dem AutoCAD-Layer STREETS befinden, und gibt eine Liste mit dem neuen Feature-Layer-Namen zurück:
("ROADS")Rückgabewerte
- Gibt bei erfolgreicher Ausführung eine Liste mit dem neuen Dokument-Feature-Layer-Namen 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.
Siehe auch
(esri_webfeaturelayer_add) | Fügt einen neuen Web-Feature-Layer hinzu.
(esri_weblayer_add) | Fügt einen neuen Web-Feature-Layer hinzu: Bild-Layer, Kartenbild-Layer oder Web-Feature-Layer.
(esri_docfeaturelayer_setquery) | Definiert den Abfragefilter für einen Dokument-Feature-Layer.