El método MapLayer.AddAsync agrega una capa de imágenes o mapas al dibujo actual utilizando las propiedades de servicio especificadas. La capa utilizará el sistema de coordenadas actual del dibujo al cual se ha agregado. Si la capa se agrega a un dibujo que no contiene ningún sistema de coordenadas, el dibujo lo heredará de la capa. Este método devuelve el número de índice de la capa agregada, que se utiliza para identificar la capa de mapas o de imágenes en otros métodos como MapLayer.Get.
Declaración
public async Task<int?> Esri.ArcGISForAutoCAD.MapLayer.AddAsync(Document doc, string url, int transparency = 30)
Parámetros
| Tipo | Nombre | Descripción | Requerido |
|---|---|---|---|
Documento | doc | Documento de AutoCAD sobre el que se va a actuar. | obligatorio |
cadena | url | Ruta válida a una capa de mapas o imágenes de ArcGIS. | obligatorio |
int | transparency | Porcentaje de transparencia de imagen que se va a aplicar al mapa (los valores son 0-99, cero es opaco). | opcional (el valor predeterminado es 30) |
Devoluciones
| Tipo | Descripción |
|---|---|
int? | Número de índice de la nueva capa de imágenes o mapas. |
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.
Ejemplo
Agregue la capa de mapas desde la URL indicada con un 70 por ciento de transparencia e imprima su número de índice.// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;
var url = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Water_Network/MapServer";
// Add the map layer
var mapLayerId = await Esri.ArcGISForAutoCAD.MapLayer.AddAsync(doc, url, 70);
// Print the index number of the map layer
doc.Editor.WriteMessage(mapLayerId.ToString());
/* Example output
1
*/
Consulte también
MapLayer.Set: método de .NET que modifica las propiedades de una capa de imágenes o mapas existente en el dibujo con las propiedades de servicio especificadas.
esri_maplayer_add: función de AutoLISP que agrega una capa de imágenes y mapas al dibujo actual utilizando las propiedades de servicio especificadas.
esri_maplayer_addasync: función de AutoLISP que agrega una capa de imágenes y mapas al dibujo actual utilizando las propiedades de servicio especificadas de forma asincrónica.