FeatureLabel.Place (.NET)

Die Methode FeatureLabel.Place erstellt ein neues Textobjekt aus dem Inhalt eines vorhandenen Feldes eines Web- oder eines Dokument-Feature-Layers. Sie können Feature-Attributfeldwerte mit den meisten Typen von Feature-Attributfeldern verknüpfen. Sie können nicht Berichterstellungsfelder mit Text- oder Blockattributwerten verknüpfen.

Deklaration

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

Parameter

Typ	Name	Beschreibung	Erforderlich
Dokument	doc	Das AutoCAD-Dokument, das bearbeitet werden soll.	Erforderlich
Zeichenfolge	flName	Ein vorhandener Feature-Layer-Name in der Zeichnung.	Erforderlich
Zeichenfolge	fieldName	Die Quelle für den Feature-Attributfeldnamen für die Beschriftung.	Erforderlich
ObjectId	featureObjId	Die AutoCAD-ObjectId des Features, das mit dem angegebenen Text verknüpft werden soll.	Erforderlich
Point3d	placePoint	Ein 3D-Punkt, bei dem die neue Textbeschriftung platziert wird.	Erforderlich
Double	textSize	Die Texthöhe der neu zu platzierenden Beschriftung.	Optional

Rückgaben

Typ	Beschreibung
ObjectId	Die AutoCAD-ObjectId des erstellten Textobjekts.

Anmerkungen zu Fehlerbedingungen

Diese Methode kann eine Ausnahme auslösen oder null zurückgeben, wenn ein Parameter ungültig ist.

Beispiel

Platzieren einer Textbeschriftung für den Attributwert Owner eines ausgewählten Parcels-Features und Ausgeben der AutoCAD-ObjectId des neuen Textobjekts.

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

Weitere Informationen

esri_label_place: Eine AutoLISP-Funktion, die eine Beschriftung für eine Feature-Attributbeschriftung platziert.

FeatureLayer.SelectEntity: Eine .NET-Methode, die zur Auswahl eines Objekts auffordert und dessen AutoCAD-ObjectId zurückgibt.