Метод 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, которая добавляет определение векторного слоя документа в чертеж.