Die Methode MapLayer.Extract konvertiert einen sichtbaren Karten- oder Bilddaten-Layer von Esri in eine standardmäßige AutoCAD-Raster-Grafik und speichert diese als Grafikdatei im angegebenen Dateiverzeichnis. Der Karten- oder Bilddaten-Layer muss in der Zeichnung sichtbar sein. Der Karten-Layer verbleibt nach der Extraktion in der Zeichnung. Verwenden Sie die Methode MapLayer.Remove, um einen Karten-Layer zu entfernen.
Deklaration
public bool Esri.ArcGISForAutoCAD.MapLayer.Extract(Document doc, int mapLayerId, string imageFilePath)
Parameter
| Typ | Name | Beschreibung | Erforderlich |
|---|---|---|---|
Dokument | doc | Das AutoCAD-Dokument, das bearbeitet werden soll. | Erforderlich |
Int | mapLayerId | Die dem Layer, der mit MapLayer.Names abgerufen werden kann, zugeordnete ganzzahlige Indexnummer. | Erforderlich |
Zeichenfolge | imageFilePath | Der Dateipfad zur neuen Bilddatei, die aus dem angegebenen Karten- oder Bilddaten-Layer erstellt wird. Dieser Parameter überschreibt die Datei, es sei denn, die Datei ist derzeit geöffnet oder wird anderweitig von einer anderen Ressource verwendet. | Erforderlich |
Rückgaben
| Typ | Beschreibung |
|---|---|
Boolesch | true, wenn der Karten- oder Bilddaten-Layer erfolgreich extrahiert wurde. |
Anmerkungen zu Fehlerbedingungen
Diese Methode kann eine Ausnahme auslösen oder false oder null zurückgeben, wenn ein Parameter ungültig ist.
Beispiel
Ausgeben der Erfolgsmeldung für das Extrahieren des Karten- oder Bilddaten-Layers mit der Indexnummer 2 als PNG-Bild mit dem Namen myExtractedLayer.png.// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;
var mapLayerId = 2;
var imageFilePath = @"C:\myExtractedData\myExtractedLayer.png";
// Extract the map layer
var success = Esri.ArcGISForAutoCAD.MapLayer.Extract(doc, mapLayerId, imageFilePath);
// Print the success
doc.Editor.WriteMessage(success.ToString());
/* Example output
True
*/
Weitere Informationen
MapLayer.Names: Eine .NET-Methode, die ein indiziertes Wörterbuch der Namen von Karten- und Bilddaten-Layern zurückgibt, die in der aktuellen Zeichnung enthalten sind.
MapLayer.Remove: Eine .NET-Methode, die den angegebenen Karten- oder Bilddaten-Layer entfernt, auf den durch seine Kartenindexnummer verwiesen wird.
esri_maplayer_extract: Eine AutoLISP-Funktion, die einen sichtbaren Karten- oder Bilddaten-Layer von Esri in eine standardmäßige AutoCAD-Raster-Grafik konvertiert und diese als Grafikdatei im angegebenen Dateiverzeichnis speichert.