Die Funktion esri_label_generate generiert mithilfe von Werten aus dem angegebenen Attributfeld Beschriftungen für die ausgewählten Features des angegebenen Feature-Layers. Sie können optionale Textparameter verwenden, um einen Versatz für den Text festzulegen und die Standardtextgröße außer Kraft zu setzen. 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.
Syntax
(esri_label_generate flname field [label_properties])
Argumente
- flname | Zeichenfolge | erforderlich | Ein vorhandener Web-Feature-Layer-Name in der Zeichnung.
- field | Zeichenfolge | erforderlich | Der mit der Beschriftung verknüpfte Feature-Layer-Feldname.
- label_properties | Assoziationsliste | optional | Eine Assoziationsliste der Feature-Layer-Feldeigenschaften in Form von Paarlisten (dotted pairs), wie sie in der folgenden Tabelle definiert sind:
| Assoziierte Bezeichnung | Wertetyp | Wertbeschreibung | Erforderlich/Optional |
|---|---|---|---|
| "OFFSET" | Liste mit drei Doubles | Eine Liste mit drei Doubles, die den Versatzabstand vom Standardbeschriftungspunkt in der X-, Y- und Z-Richtung enthält | Optional |
| "TEXTSIZE" | Double | Die Textgröße der generierten Beschriftungen | Optional |
Beispiel für die Verwendung
Generieren Sie Beschriftungen für das Feld Owner des Feature-Layers Parcels, wobei der Text 10 Einheiten nach oben und nach rechts vom Standardbeschriftungspunkt versetzt ist und eine Textgröße von 7 Einheiten hat.(esri_label_generate "Parcels" "Owner"
(list
(cons "OFFSET" '(10 10 0))
(cons "TEXTSIZE" 7.0)
)
)
Ergebnis des Beispiels für die Verwendung
Generiert Textobjekte als verknüpfte Beschriftungen und gibt eine Liste mit "true" zurück:
(T)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
Ein Rückgabewert mit einem Fehler kann eine der folgenden Ursachen haben:
- (nil ("Error" . "Feature layer not found."))
Die angegebene Datei wurde nicht gefunden.
- (nil ("Error" . "Field not found."))
Der Quell-Feature-Layer field ist in der Zeichnung nicht vorhanden.
- (nil ("Error" . "Missing required argument."))
Mindestens ein erforderliches Argument wurde nicht angegeben.