Skip To Content

DocFeatureLayer.Add (.NET)

La méthode DocFeatureLayer.Add ajoute une définition de couche d’entités de document au dessin AutoCAD.

Prenez en compte les points suivants lorsque vous utilisez cette méthode :

  • Si le type de géométrie et le filtre de couche sont omis, la couche d’entités est créée sans filtre de requête et le paramètre geomTypeString est défini sur Point.
  • Si le paramètre layerFilter facultatif est inclus, il est utilisé en tant que valeur QUERYFILTER.
  • Si vous devez spécifier un filtre de requête plus sophistiqué, utilisez la méthode DocFeatureLayer.SetQuery.
  • Si le nom de la nouvelle couche d’entités existe déjà, le nom spécifié est ajouté avec un numéro à la fin de ce nom.

Déclaration

public string Esri.ArcGISForAutoCAD.DocFeatureLayer.Add(Document doc, string flName, string geomTypeString = "Point", IEnumerable<string> layerFilter = null)

Paramètres

TypeNomDescriptionRequis

Document

doc

Document AutoCAD sur lequel intervenir.

required

chaîne

flName

Nom de la nouvelle couche d’entités de document.

required

chaîne

geomTypeString

Type géométrique de la nouvelle couche d’entités : "Polygon", "Point", "Polyline", "Annotation" ou "Multipatch".

facultatif (Point est défini par défaut)

IEnumerable<chaîne>

layerFilter

Un ou plusieurs noms de couches AutoCAD pour définir le paramètre QUERYFILTER de la nouvelle classe d’entités.

facultatif ("*" est défini par défaut, ce qui correspond à toutes les couches)

Retours

TypeDescription

chaîne

Nom de la nouvelle couche d’entités de document.

Remarques sur les conditions d’erreur

Si un paramètre n’est pas valide, cette méthode peut générer une exception ou renvoyer une chaîne vide ou null.

Exemple

Ajouter une couche d’entités 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 afficher le nom correspondant.

// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;

// Add the document feature layer
var layerFilter = new List<string> { "STREETS" };
var newDfl = Esri.ArcGISForAutoCAD.DocFeatureLayer.Add(doc, "Roads", "Polyline", layerFilter);

// Print the document feature layer name
doc.Editor.WriteMessage(newDflName);

/* Example output
Roads
*/

Voir aussi

WebFeatureLayer.AddAsync : méthode .NET qui ajoute une nouvelle couche d’entités Web avec une requête de filtrage facultative.

DocFeatureLayer.SetQuery : méthode .NET qui modifie la valeur QUERYFILTER d’une couche d’entités de document existante.

esri_docfeaturelayer_add : fonction AutoLISP qui ajoute une définition de couche d’entités de document au dessin.