Die Methode FeatureLabel.Set fügt die Beziehung zwischen dem Attributfeld eines Features und eines AutoCAD-TEXT-, -MTEXT, -DIMENSION- oder ATTDEF-Objekts hinzu bzw. ändert diese.
Beachten Sie bei der Verwendung der Methode FeatureLabel.Set Folgendes:
- Wird der Wert des Textes eines Beschriftungsobjekts geändert, wird der Attributwert des verlinkten Features automatisch aktualisiert.
- Wenn der Attributwert des verlinkten Features geändert wird, ändert sich der Wert im verlinkten Textobjekt automatisch entsprechend.
- 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.
- Verknüpfte DIMENSION-Objekte sind schreibgeschützt. Der verknüpfte Feldwert wird vom DIMENSION-Text abgeleitet.
Deklaration
public bool Esri.ArcGISForAutoCAD.FeatureLabel.Set(Document doc, string flName, string fieldName, ObjectId featureObjectId, ObjectId textObjectId)
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 | featureObjectId | Die AutoCAD-ObjectId des Features, das mit dem angegebenen Text verknüpft werden soll. | Erforderlich |
ObjectId | textObjectId | Die AutoCAD-ObjectId des Textobjekts zum Verknüpfen als Feldattributwert. | Erforderlich |
Rückgaben
| Typ | Beschreibung |
|---|---|
Boolesch | true, wenn die Beschriftung erfolgreich festgelegt wurde. |
Anmerkungen zu Fehlerbedingungen
Diese Methode kann eine Ausnahme auslösen oder false oder null zurückgeben, wenn ein Parameter ungültig ist.
Beispiel
Ausgeben der Erfolgsmeldung für die Auswahl eines Features des Feature-Layers "Parcels" und eines Textobjekts zum Festlegen des Werts des Felds 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
*/
Weitere Informationen
esri_label_set: Eine AutoLISP-Funktion, die die Beziehung zwischen einem Attributfeld eines Features und einem AutoCAD-TEXT-, -MTEXT-, -DIMENSION- oder -ATTDEF-Objekt hinzufügt.