Skip To Content

FeatureLabel.Place (.NET)

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

TipoNombreDescripciónRequerido

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

TipoDescripció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.