El método FeatureLabel.Place crea una nueva entidad de texto a partir del contenido de un campo existente o una capa de entidades de documento o web. 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.
Declaración
public ObjectId Esri.ArcGISForAutoCAD.FeatureLabel.Place(Document doc, string flName, string fieldName, ObjectId featureObjId, Point3d placePoint, double textSize = 0)
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 | featureObjId | ObjectId de AutoCAD de la entidad que se va a vincular con el texto especificado. | obligatorio |
Point3d | placePoint | Punto 3D en el cual se colocará la nueva etiqueta de texto. | obligatorio |
doble | textSize | Altura del texto de la nueva etiqueta de texto que se va a colocar. | opcional |
Devoluciones
| Tipo | Descripción |
|---|---|
ObjectId | ObjectId de AutoCAD de la entidad de texto creada. |
Observaciones sobre las condiciones de error
Este método puede generar una excepción o devolver null si un parámetro no es válido.
Ejemplo
Coloque una etiqueta de texto para el valor de atributo Owner de una entidad de Parcels seleccionada e imprima la AutoCAD ObjectId de la nueva entidad de texto.// 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)
*/
Consulte también
esri_label_place: función de AutoLISP que coloca una etiqueta de atributo de entidad.
FeatureLayer.SelectEntity: método de .NET que solicita la selección de una entidad y devuelve su ObjectId de AutoCAD.