FeatureLabel.Place (.NET)

La méthode FeatureLabel.Place crée une nouvelle entité textuelle à partir du contenu d’un champ existant d’une couche d’entités Web ou de document. 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.

Déclaration

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

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	featureObjId	ObjectID AutoCAD de l’entité à lier au texte spécifié.	required
Point3d	placePoint	Point 3D où la nouvelle étiquette textuelle sera placée.	required
réel double	textSize	Hauteur de texte de la nouvelle étiquette textuelle à placer.	facultatif

Retours

Type	Description
ObjectID	ObjectID AutoCAD de l’entité textuelle créée.

Remarques sur les conditions d’erreur

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

Exemple

Placer une étiquette textuelle pour la valeur attributaire Owner d’une entité Parcels sélectionnée et afficher l’ObjectId AutoCAD de la nouvelle entité textuelle.

// 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)
*/

Voir aussi

esri_label_place : fonction AutoLISP qui place une étiquette attributaire d’entité.

FeatureLayer.SelectEntity : méthode .NET qui invite à sélectionner une seule entité et renvoie son ObjectID AutoCAD.