Skip To Content

DocFeatureLayer.Add (.NET)

Метод DocFeatureLayer.Add добавляет определение векторного слоя документа в чертеж AutoCAD.

При использовании этого метода, учитывайте следующее:

  • Если тип геометрии и фильтр слоев не указаны, векторный слой будет создан без фильтра запроса, а для параметра geomTypeString будет установлено значение Точка.
  • Если включен дополнительный параметр layerFilter, он используется как значение QUERYFILTER.
  • Если требуется более сложный фильтр запроса, используйте метод DocFeatureLayer.SetQuery.
  • Если имя нового векторного слоя уже существует, то указанное имя добавится с номером в конце.

Декларация

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

Параметры

ТипИмяОписаниеОбязательный

Документ

doc

Документ AutoCAD, на основании которого следует действовать.

required

string

flName

Имя нового векторного слоя документа.

required

string

geomTypeString

Тип геометрии нового векторного слоя: "Polygon", "Point", "Polyline", "Annotation" или "Multipatch".

дополнительно (по умолчанию Point.)

IEnumerable<string>

layerFilter

Одно или несколько имен слоев AutoCAD для определения QUERYFILTER нового класса объектов.

дополнительно (по умолчанию "*", то есть все слои.)

Возвращаемые значения

ТипОписание

string

Имя нового векторного слоя документа.

Замечания по условиям возникновения ошибок

Этот метод может выдать исключение или вернуть пустую строку или null, если параметр является некорректным.

Пример

Добавьте слой полилинейных объектов документа с именем Roads, где элементы, определяющие векторный слой, находятся на слое AutoCAD STREETS, и выведите его имя.

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

См. также

WebFeatureLayer.AddAsync — метод .NET, который добавляет новый векторный веб-слой с дополнительным фильтрующим запросом.

DocFeatureLayer.SetQuery - метод .NET, который изменяет значение QUERYFILTER существующего векторного слоя документа.

esri_docfeaturelayer_add — функция AutoLISP, которая добавляет определение векторного слоя документа в чертеж.