Diese Funktion fügt die Beziehung zwischen einem Attributfeld eines Features und einem TEXT-, MTEXT-, DIMENSION- oder ATTDEF-AutoCAD-Objekt hinzu bzw. ändert sie.
- 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 mit.
- Sie können Feature-Attributfeldwerte mit den meisten Arten 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.
Syntax
(esri_label_set flname field feature_ename text_ename)
Argumente
- flname | Zeichenfolge | erforderlich | Ein vorhandener Feature-Layer-Name in der Zeichnung
- field | Zeichenfolge | erforderlich | Ein vorhandener Attributfeldname des Feature-Layers in der Zeichnung
- feature_ename | Zeichenfolge | erforderlich | Der AutoCAD-Objektname des Features zum Verknüpfen mit dem angegebenen Text
- text_ename | Zeichenfolge | erforderlich | Der AutoCAD-Objektname des Textobjekts zum Verknüpfen als Feldattributwert
Beispiel für die Verwendung
Fordert zur grafischen Auswahl eines Features des Feature-Layers Parcels auf. Dann muss ein Textobjekt ausgewählt werden, um den Wert des Feldes Owner festzulegen.(progn
(setq feature_ent (car (entsel)))
(setq text_ent (car (entsel)))
(esri_label_set "Parcels" "Owner" feature_ent txt_ent)
)
Ergebnis des Beispiels für die Verwendung
Der Wert des ausgewählten Textobjekts wird als Wert des Feldes Owner des ausgewählten Features verknüpft und gibt eine Liste mit "true" zurück.
(T)Rückgabewerte
Folgende Werte sind mögliche Rückgabewerte:
- Bei erfolgreicher Ausführung gibt die Funktion eine Liste mit "true" zurück: (T)
- Wenn bei dem Vorgang ein Fehler auftritt, wird eine Liste zurückgegeben, in der der erste Wert nil lautet. Anschließend wird eine Assoziationsliste mit dem Schlüsselwert "Error" sowie eine entsprechende Fehlermeldung in Form einer Zeichenfolge zurückgegeben: (nil ("Error" . "<message>")).
Rückgabewerte mit Fehlern
Rückgabewerte mit Fehlern können eine der folgenden Ursachen haben:
- (nil ("Error" . "Missing required argument."))
Eines der erforderlichen Argumente wurde nicht angegeben.
- (nil ("Error" . "No valid fields specified."))
Beim angegebenen Feld handelt es sich nicht um ein gültiges Feld des angegebenen Feature-Layers.
- (nil ("Error" . "Feature layer not found."))
Beim angegebenen Feature-Layer-Wert handelt es sich nicht um einen gültigen Feature-Layer in der Zeichnung.