FeatureLabel.Set (.NET)

La méthode FeatureLabel.Set ajoute ou modifie la relation entre un champ attributaire d’une entité et une entité AutoCAD TEXT, MTEXT, DIMENSION ou ATTDEF.

Gardez à l’esprit les informations suivantes lorsque vous utilisez la méthode FeatureLabel.Set :

• Si la valeur textuelle de l’entité d’étiquette est modifiée, la valeur attributaire de l’entité liée est mise à jour automatiquement.
• Si la valeur attributaire de l’entité liée est modifiée, la valeur de l’entité textuelle liée est mise à jour automatiquement.
• Vous pouvez lier des valeurs de champ attributaire d’entité à la plupart des types de champ attributaire d’entité.
• Vous ne pouvez pas lier des champs de suivi à des valeurs attributaires de type texte ou bloc.
• Les entités DIMENSION liées sont en lecture seule. La valeur du champ lié est dérivée du texte DIMENSION.

Déclaration

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

Paramètres

Type	Nom	Description	Requis
Document	doc	Document AutoCAD sur lequel intervenir.	required
chaîne	flName	Nom de couche d’entités existant dans le dessin.	required
chaîne	fieldName	Source du nom du champ attributaire de l’entité pour l’étiquette.	required
ObjectID	featureObjectId	ObjectID AutoCAD de l’entité à lier au texte spécifié.	required
ObjectID	textObjectId	ObjectID AutoCAD de l’entité textuelle à lier en tant que valeur attributaire de champ.	required

Retours

Type	Description
bool	true si l’étiquette a été définie

Remarques sur les conditions d’erreur

Si un paramètre n’est pas valide, cette méthode peut générer une exception, renvoyer false ou null.

Exemple

Afficher la sélection d’une entité de la couche d’entités Parcels (Parcelles) et d’une entité textuelle pour définir la valeur du champ 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
*/

Voir aussi

esri_label_set : fonction AutoLISP qui ajoute ou modifie la relation entre un champ attributaire d’une entité et une entité AutoCAD TEXT, MTEXT, DIMENSION ou ATTDEF.