FeatureLabel.Set (.NET)

FeatureLabel.Set 方法用于添加或修改要素属性字段与 AutoCAD、TEXT、MTEXT、DIMENSION 或 ATTDEF 实体之间的关系。

当使用 FeatureLabel.Set 方法时，请记住以下几点：

• 如果修改了标注实体的文本值，链接要素的属性值会自动更新。
• 如果修改了链接要素的属性值，则链接文本实体中的值会自动更新。
• 可以将要素属性字段值链接到大多数类型的要素属性字段。
• 无法将报告字段链接到文本或块属性值。
• 链接的 DIMENSION 实体为只读。 链接的字段值将从 DIMENSION 文本获取。

声明

public bool Esri.ArcGISForAutoCAD.FeatureLabel.Set(Document doc, string flName, string fieldName, ObjectId featureObjectId, ObjectId textObjectId)

参数

类型	名称	描述	必填
文档	doc	要进行操作的 AutoCAD 文档。	必填
string	flName	工程图中现有的要素图层名称。	必填
string	fieldName	标注的要素属性字段名称源。	必填
ObjectId	featureObjectId	要链接到指定文本的要素的 AutoCAD ObjectId。	必填
ObjectId	textObjectId	要链接为字段属性值的文本实体的 AutoCAD ObjectId。	必填

返回

类型	描述
bool	如果已成功设置标注，则为 true

错误条件备注

如果参数无效，则此方法可能会抛出异常或者返回 false 或 null。

示例

打印选择 Parcels 要素图层的要素和文本实体以设置 Owner 字段值成功。

// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;
var flName = "Parcels";
var fieldName = "Owner";
var featureObjId = Esri.ArcGISForAutoCAD.FeatureLayer.SelectEntity(doc, flName);
var textObjId = doc.Editor.GetEntity(new PromptEntityOptions("\nSelect text entity: ")).ObjectId;

// Set the label
var success = Esri.ArcGISForAutoCAD.FeatureLabel.Set(doc, flName, fieldName, featureObjId, textObjId);
       
// Print the success
doc.Editor.WriteMessage(success.ToString());

/* Example output 
True
*/

另请参阅

esri_label_set - 此 AutoLISP 函数用于添加或修改要素属性字段与 AutoCAD、TEXT、MTEXT、DIMENSION 或 ATTDEF 实体之间的关系。