Die Funktion esri_coordsys_DatumTransformation_remove entfernt eine Datumstransformation aus der aktuellen Zeichnung. Datumstransformationen sind zwischen den Ausgangs- und Ziel-Koordinatensystemen in einer Zeichnung eindeutig. Diese eindeutigen Datumstransformationsdefinitionen werden mithilfe der Koordinatensysteme FromCS und ToCS beim Erstellen und Entfernen ermittelt. Verwenden Sie die Funktion esri_coordsys_DatumTransformations, um eine Liste der in der Zeichnung gespeicherten Datumstransformationen zu erhalten.
Syntax
(esri_coordsys_DatumTransformation_remove FromCS ToCS)
Argumente
- FromCS | Zeichenfolge | Erforderlich | Eine gültige Well-known ID (WKID) oder der Well-Known Text (WKT) des Esri Koordinatensystems als Zeichenfolge.
- ToCS | Zeichenfolge | Erforderlich | Eine gültige Well-known ID (WKID) oder der Well-Known Text (WKT) des Esri Koordinatensystems als Zeichenfolge.
Hinweis:
Beim Erstellen eines WKT als AutoLISP-Zeichenfolgenargument muss die Zeichenfolge die korrekten Escape-Zeichen enthalten, um die notwendigen Anführungszeichen in die Textzeichenfolge einzubinden. Beispiel:
Koordinatensystem
"PROJCS[\"NAD_1983_HARN_StatePlane_Florida_West_FIPS_0902_Feet\",GEOGCS[\"GCS_North_American_1983_HARN\",DATUM[\"D_North_American_1983_HARN\",SPHEROID[\"GRS_1980\",6378137.0,298.257222101]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433]],PROJECTION[\"Transverse_Mercator\"],PARAMETER[\"False_Easting\",656166.6666666665],PARAMETER[\"False_Northing\",0.0],PARAMETER[\"Central_Meridian\",-82.0],PARAMETER[\"Scale_Factor\",0.9999411764705882],PARAMETER[\"Latitude_Of_Origin\",24.33333333333333],UNIT[\"Foot_US\",0.3048006096012192],AUTHORITY[\"EPSG\",2882]]"Beispiel 1 für die Verwendung
Entfernen der vorhandenen Datumstransformation aus der aktuellen Zeichnung zwischen den angegebenen Ausgangs- und Ziel-Koordinatensystemen zu entfernen.(esri_coordsys_DatumTransformation_remove "2882" "3857")
Ergebnis des Beispiels 1 für die Verwendung
Die vorhandene Datumstransformation wird entfernt, und die Funktion gibt eine Liste mit "true" (T) zurück.
(T)Beispiel 2 für die Verwendung
Entfernt die vorhandene Datumstransformation aus der aktuellen Zeichnung.(esri_coordsys_DatumTransformation_remove "6543" "3857")
Ergebnis des Beispiels 2 für die Verwendung
Die vorhandene Datumstransformationsdefinition wird wegen eines vorhandenen Web-Feature-Layers in der aktuellen Zeichnung nicht entfernt. Es wird eine Fehlermeldung zurückgegeben.
(nil ("Error" . "This document contains existing web feature layers. Datum transformations cannot be modified when web feature layers present."))Rückgabewerte
Folgende Werte sind mögliche Rückgabewerte:
Bei Erfolg wird die vorhandene Datumstransformation entfernt, und die Funktion gibt eine Liste mit "true" (T) zurück.
- 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" . "Failed"))
Der eingegebene Wert für WKID oder WKT ist ungültig.
- (nil ("Error" . "Missing required argument."))
Mindestens eines der erforderlichen Argumente wurde nicht angegeben.
- (nil ("Error" . "This document contains existing web feature layers. Datum transformations cannot be modified when web feature layers present."))
Datumstransformationen können nicht entfernt oder geändert werden, wenn das Dokument vorhandene Web-Feature-Layer enthält.