Mit der Funktion wird der Standardelementtyp eines Punkt-Feature-Layers festgelegt. Wenn der Vorgang erfolgreich war, werden diese Einstellungen zurückgegeben.
Syntax
(esri_featurelayer_setDefaultElementType flname subtype element_settings)
Argumente
- flname | Zeichenfolge | erforderlich | Ein vorhandener Punkt-Feature-Layer-Name in der Zeichnung.
- subtype | Zeichenfolge | erforderlich | Ein vorhandener Punkt-Feature-Layer-Subtype-Name in der Zeichnung. Geben Sie "" für eine leere Zeichenfolge ein, wenn kein Subtype angegeben wurde.
- element_settings | Assoziationsliste | erforderlich | Eine Assoziationsliste der Einstellungen in Form von Paarlisten (dotted pairs), die wie folgt definiert sind:
| Assoziierte Bezeichnung | Wertetyp | Wertbeschreibung | Erforderlich oder optional |
|---|---|---|---|
| TYPE | Zeichenfolge | Der Standardelementtyp POINT, Block Reference oder AECC_COGO_POINT | Erforderlich |
| DESCRIPTION | Zeichenfolge | Der Blockname, wenn der Typ Block Reference ist, oder eine Beschreibung, wenn der Typ AECC_COGO_POINT ist | Erforderlich |
Beispiel für die Verwendung
Legen Sie die Standardelementeinstellungen eines Feature-Layers namens Damage_to_Residential_Buildings ohne Subtype als AutoCAD-Blockreferenz namens Damaged_Structure fest.(esri_featurelayer_setDefaultElementType
"Damage_to_Residential_Buildings"
""
(list (cons "TYPE" "Block Reference") (cons "DESCRIPTION" "Damaged_Structure"))
)
Ergebnis des Beispiels für die Verwendung
Legen Sie den Standardelementtyp des Feature-Layers fest, und geben Sie element_settings als Assoziationsliste zurück:
(("TYPE"."Block Reference")("DESCRIPTION"."Damaged_Structure"))Rückgabewerte
Von dieser Funktion wird ein Wert zurückgegeben.
- Bei erfolgreicher Ausführung wird eine Assoziationsliste zurückgegeben, in der der Wert TYPE der Objekttyp POINT, Block Reference oder AECC_COGO_POINT und der Wert DESCRIPTION der Blockreferenzname oder das Beschreibungspräfix des Koordinatenpunktes 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 ("Error" . "Missing required argument."))
Eines von drei erforderlichen Argumenten wurde nicht angegeben.
- (nil ("Error" . "Unsupported geometry type."))
Die Funktion kann nur mit Punkt-Feature-Layern verwendet werden.
- (nil ("Error" . "No feature layer specified"))
Kein gültiger Feature-Layer wurde angegeben.
- (nil ("Error" . "Feature layer not found."))
Der angegebene Feature-Layer ist in der Datei nicht vorhanden.
- (nil ("Error" . "Subtype name does not exist."))
Der angegebene Subtype ist nicht vorhanden.