DocFeatureLayer.Add (.NET)

El método DocFeatureLayer.Add agrega una definición de capa de entidades de documento al dibujo de AutoCAD.

Cuando utilice este método, tenga en cuenta lo siguiente:

• Si se omiten el tipo de geometría y el filtro de capa, se creará la capa de entidades sin filtro de consulta y el parámetro geomTypeString se definirá como punto.
• Si se incluye el parámetro layerFilter opcional, se utiliza como valor de QUERYFILTER.
• Si se necesita un filtro de consulta más sofisticado, utilice el método DocFeatureLayer.SetQuery
• Si el nuevo nombre de la capa de entidades ya existe, se agregará el nombre especificado con un número consecutivo incorporado.

Declaración

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

Parámetros

Tipo	Nombre	Descripción	Requerido
Documento	doc	Documento de AutoCAD sobre el que se va a actuar.	obligatorio
cadena	flName	Nuevo nombre de la capa de entidades de documento.	obligatorio
cadena	geomTypeString	Tipo geométrico de la nueva capa de entidades: "Polygon", "Point", "Polyline", "Annotation" o "Multipatch".	opcional (el valor predeterminado es Point)
IEnumerable<string>	layerFilter	Uno o más nombres de capas de AutoCAD para definir un QUERYFILTER de la nueva clase de entidad.	opcional (el valor predeterminado es "*", que son todas las capas)

Devoluciones

Tipo	Descripción
cadena	Nuevo nombre de la capa de entidades de documento.

Observaciones sobre las condiciones de error

Este método puede generar una excepción o devolver una cadena de caracteres vacía o null si un parámetro no es válido.

Ejemplo

Agrega una capa de entidades de documento de polilínea llamada Roads en la que las entidades que definen la capa de entidades están en la capa AutoCAD STREETS e imprima su nombre.

// 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
*/

Consulte también

WebFeatureLayer.AddAsync: método de .NET que agrega una nueva capa de entidades web con una consulta de filtrado opcional.

DocFeatureLayer.SetQuery: método de .NET que modifica el valor QUERYFILTER de una capa de entidades de documento existente.

esri_docfeaturelayer_add: función de AutoLISP que agrega una definición de capa de entidades de documento al dibujo.