FeatureLabel.Set (.NET)

El método FeatureLabel.Set agrega o modifica la relación entre un campo de atributo de una entidad y una entidad AutoCAD TEXT, MTEXT, DIMENSION o ATTDEF.

Tenga en cuenta la siguiente información cuando utilice el método FeatureLabel.Set:

• Si se modifica el valor de texto de la entidad de la etiqueta, el valor del atributo de la entidad vinculada se actualiza automáticamente.
• Si el valor de atributo de la entidad vinculada se modifica, el valor de la entidad de texto vinculada se actualiza automáticamente.
• Es posible vincular valores de campo de atributos de entidades a la mayoría de tipos de campos de atributos de entidades.
• No es posible vincular los campos de informe con valores de atributos de texto o bloque.
• Las entidades DIMENSION vinculadas son de solo lectura. El valor de campo vinculado se deriva del texto DIMENSION.

Declaración

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

Parámetros

Tipo	Nombre	Descripción	Requerido
Documento	doc	Documento de AutoCAD sobre el que se va a actuar.	obligatorio
cadena	flName	Nombre de capa de entidades existente en el dibujo.	obligatorio
cadena	fieldName	Origen del nombre de campo de atributos de entidades para la etiqueta.	obligatorio
ObjectId	featureObjectId	ObjectId de AutoCAD de la entidad que se va a vincular con el texto especificado.	obligatorio
ObjectId	textObjectId	ObjectId de AutoCAD de la entidad de texto para vincular como un valor de atributo de campo	obligatorio

Devoluciones

Tipo	Descripción
bool	true si la etiqueta se ha definido correctamente

Observaciones sobre las condiciones de error

Este método puede generar una excepción o devolver false o null si un parámetro no es válido.

Ejemplo

Imprima el resultado correcto de seleccionar una entidad de la capa de entidades de parcela y la entidad de texto para configurar el valor del campo 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
*/

Consulte también

esri_label_set: función de AutoLISP que agrega o modifica la relación entre un campo de atributo de una entidad y una entidad AutoCAD TEXT, MTEXT, DIMENSION o ATTDEF.