Die Funktion esri_label_get gibt eine Liste zurück, die den Objektnamen der Beschriftung eines Textobjekts enthält, das mit einem angegebenen Feature-Attributfeld eines Features verknüpft ist.
Syntax
(esri_label_get field ename)
Argumente
- field | Zeichenfolge | erforderlich | Der Feldname des Feature-Layers.
- ename | AutoCAD-Objektname | erforderlich | Der AutoCAD-Objektname des verknüpften Features.
Beispiel für die Verwendung
Versuchen, den Objektnamen des Textobjekts abzurufen, das mit dem Feld Owner des ausgewählten Features verknüpft ist.(setq text_EID (car (esri_label_get "Owner" (car (entsel)))))
Ergebnis des Beispiels für die Verwendung
Gibt nur den Objektnamen aus der Liste zurück, die den Objektnamen des Textobjekts enthält, das mit dem Feld Owner des ausgewählten Features verknüpft ist:<Entity name: 1450e1b79f0>
Rückgabewerte
Folgende Werte sind mögliche Rückgabewerte:
- Bei erfolgreicher Ausführung gibt die Funktion eine Liste zurück, die die Objektnamen des Objekts TEXT, MTEXT oder ATTRIBUTE enthält, das mit dem angegebenen Feature-Attributfeld verknüpft ist.
- 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
Ein Rückgabewert mit einem Fehler kann eine der folgenden Ursachen haben:
- nil
Der angegebene Feldname war ungültig oder es lagen andere Fehler vor.
- (nil ("Error" . "Missing required argument."))
Mindestens eines der erforderlichen Argumente wurde nicht angegeben.
- (nil ("Error" . "No label found."))
Das ausgewählte Feature befindet sich nicht in dem Feature-Layer.