Skip To Content

CoordinateSystem.DatumTransformations (.NET)

El método CoordinateSystem.DatumTransformations devuelve todas las definiciones de transformación de datum en el dibujo como un conjunto de diccionarios.

La combinación del sistema de coordenadas from y del sistema de coordenadas to incluida en cada definición de transformación de datum es única y actúa como valores clave que distinguen una definición de transformación de datum de otra en el dibujo. Cada definición de transformación de datum incluye un conjunto de pasos para realizar la transformación. Cada paso tiene una dirección que indica el orden en el que se aplica el paso de transformación del sistema de coordenadas.

Declaración

public IEnumerable<Dictionary<string, object>> Esri.ArcGISForAutoCAD.CoordinateSystem.DatumTransformations(Document doc)

Parámetros

TipoNombreDescripciónRequerido

Documento

doc

Documento de AutoCAD sobre el que se va a actuar.

obligatorio

Devoluciones

TipoDescripción

IEnumerable<Dictionary<string, object>>

Conjunto de definiciones de transformación de datum como diccionarios. Cada diccionario de definiciones de transformación de datum tiene las claves siguientes: From, To y Steps. Las claves From y To tienen valores de cadena de caracteres que representan los sistemas de coordenadas. El valor de la clave Steps es un conjunto de diccionarios de pasos de transformación de sistemas de coordenadas. Cada diccionario de pasos de transformación tiene claves Step y Direction. La clave Step tiene un valor del paso como cadena de caracteres y la clave Direction indica el orden en que se aplicará el paso de transformación, ya sea "Forward" o "Reverse".

Observaciones sobre las condiciones de error

Este método puede generar una excepción o devolver null si un parámetro no es válido o no hay transformaciones de datum en el dibujo.

Ejemplo

Imprima las definiciones de transformación de datum en el dibujo actual.

// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;

// Get the datum transformations
var datumTransformations = Esri.ArcGISForAutoCAD.CoordinateSystem.DatumTransformations(doc);

// Print the datum transformation definitions
foreach (var dT in datumTransformations)
{
  doc.Editor.WriteMessage("\nFrom {0}: To {1}", dT["From"], dT["To"]);
  doc.Editor.WriteMessage("\nSteps: ");
  doc.Editor.WriteMessage("\n");
  foreach (var dict in dT["Steps"] as List<Dictionary<string, object>>)
  {
    foreach (var kvp in dict)
    {
      doc.Editor.WriteMessage("\t{0}: {1}\n", kvp.Key, kvp.Value.ToString());
    }
  }
}

/* Example output 
From 2882: To 3857
Steps:
 Direction: Forward
 Step: 1901
From 3857: To 4432
Steps:
 Direction: Reverse
 Step: 1173
 Direction: Forward
 Step: 1241
*/

Consulte también

esri_coordsys_DatumTransformations: función de AutoLISP que devuelve todas las definiciones de transformación de datum del dibujo como lista de listas asociadas.