FeatureLabel.Place (.NET)

Метод FeatureLabel.Place создает новый текстовый элемент из содержания существующего поля векторного веб-слоя или векторного слоя документа. Можно связать значения атрибутивных полей объекта с большинством типов атрибутивных полей объекта. Вы не можете связать поля отчета с текстом или значениями атрибутов блока.

Декларация

public ObjectId Esri.ArcGISForAutoCAD.FeatureLabel.Place(Document doc, string flName, string fieldName, ObjectId featureObjId, Point3d placePoint, double textSize = 0)

Параметры

Тип	Имя	Описание	Обязательный
Документ	doc	Документ AutoCAD, на основании которого следует действовать.	required
string	flName	Имя существующего векторного слоя в чертеже.	required
string	fieldName	Источник имени атрибутивного поля объекта для надписи.	required
ObjectId	featureObjId	AutoCAD ObjectId объекта, с которым необходимо связать указанный текст.	required
Point3d	placePoint	3D точка, в которой будет размещена новая текстовая надпись.	required
double	textSize	Высота текста новой текстовой надписи, которая будет размещена.	дополнительно

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

Тип	Описание
ObjectId	AutoCAD ObjectId созданного текстового элемента.

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

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

Пример

Разместить текстовую надпись для значения атрибута Owner выбранного объекта Parcels и вывести AutoCAD ObjectId нового текстового элемента.

// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;
var flName = "Parcels";
var featureObjId = Esri.ArcGISForAutoCAD.FeatureLayer.SelectEntity(doc, flName);
var fieldName = "Owner";
var placePoint = doc.Editor.GetPoint("Place label: ").Value;

// Place label
var labelObjId = Esri.ArcGISForAutoCAD.FeatureLabel.Place(doc, flName, fieldName, featureObjId, placePoint);

// Print the label's ObjectId
doc.Editor.WriteMessage("\nObjectId: " + labelObjId.ToString());

/* Example output 
ObjectId: (2100004115968)
*/

См. также

esri_label_place — функция AutoLISP, которая размещает надпись атрибута объекта.

FeatureLayer.SelectEntity — метод .NET, который предлагает выбрать один элемент и возвращает его AutoCAD ObjectId.