esri_docfeaturelayer_add (AutoLISP)

Ajoute une définition de couche d’entités de document au dessin AutoCAD.

Utilisation :

• Si l’argument FEATURE_LAYER_PROPERTIES est omis, la couche d’entités est créée sans filtre de requête et GEOMTYPE est défini sur Point.
• Si le paramètre facultatif LAYERFILTER est inclus, la liste de couches est utilisée en tant que QUERYFILTER.
• Si vous devez spécifier un filtre de requête plus sophistiqué qu'une liste de couches, utilisez la fonction esri_docfeaturelayer_setquery.
• Si le nom de la nouvelle couche d’entités existe déjà, alors un nombre est ajouté à la fin de ce nom.

Syntaxe

(esri_docfeaturelayer_add flname [featurelayer_properties])

Arguments

• flname | chaîne | obligatoire | Nom de la nouvelle couche d'entités de document.
• featurelayer_properties | liste associée | facultatif | Propriétés de la couche d'entités.

  Etiquette associée	Type de valeur	Description de la valeur	Requis ou facultatif
  "GEOMTYPE "	Chaîne	Type géométrique de la nouvelle couche d'entités : {"Polygon", "Point", "Polyline", "Annotation", ou "Multipatch"}	facultatif (Point est la valeur par défaut.)
  "LAYERFILTER"	Chaîne	Un ou plusieurs noms de couches AutoCAD séparés par des virgules sous forme de chaîne unique pour définir le paramètre QUERYFILTER de la nouvelle classe d'entités. Remarque : Valeur par défaut "*" = toutes les couches. Utilisez la fonction esri_docfeaturelayer_setquery pour créer un filtre de requête QUERYFILTER complexe.	facultatif

Exemple d'utilisation

Essaye d'ajouter une entité de document polyligne nommée ROADS, dans laquelle les entités qui définissent la couche d'entités sont sur la couche AutoCAD STREETS :

(esri_docfeaturelayer_add "ROADS"
(list
(cons "GEOMTYPE" "POLYLINE")
(cons "LAYERFILTER" "STREETS")
))

Exemple d’utilisation du résultat

Ajoute une entité de document polyligne nommée ROADS, dans laquelle les entités qui définissent la couche d'entités sont sur la couche AutoCAD STREETS et renvoie une liste contenant le nom de la nouvelle couche d'entités :

("ROADS")

Valeurs renvoyées

• En cas de réussite, renvoie une liste contenant le nom de la nouvelle couche d'entités de document.
• En cas d’échec, renvoie une liste avec la première valeur nil puis une liste associée contenant la valeur principale "Error" et un message d’erreur associé sous forme de chaîne : (nil ("Error" . "<message>")).

Valeurs d’échec renvoyées

Un échec peut être dû par exemple aux raisons suivantes :

• (nil ("Error" . "Missing required argument."))

  Un ou plusieurs des arguments requis n’a pas été fourni.

Voir aussi

(esri_webfeaturelayer_add) | Ajoute une nouvelle couche d'entités Web.

(esri_weblayer_add) | Ajoute une nouvelle couche Web : couche d’images, couche d’images de carte ou couche d’entités Web.

(esri_docfeaturelayer_setquery) | Définit un filtre de requête de couche d'entités de document.