MapControl.ExportMapItem Event

Occurs when executing the export action of the map item.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v20.1.dll

Declaration

public event ExportMapItemEventHandler ExportMapItem
Public Event ExportMapItem As ExportMapItemEventHandler

Event Data

The ExportMapItem event's data class is ExportMapItemEventArgs. The following properties provide information specific to this event:

Property Description
Cancel Gets or sets whether the export of a map item should be canceled.
IsSelected Gets a value that indicates whether an exported map item is selected.
Item Gets a map item to be represented in the map control. Inherited from MapItemEventArgs.

Examples

The following example demonstrates how to export selected map items to an image.

To do this, handle the MapControl.ExportMapItem event and set the ExportMapItemEventArgs.Cancel property to true if the map item is not selected (the ExportMapItemEventArgs.IsSelected property is set to false). Then, call the MapControl.ExportToImage method using the map path (where the map image should be stored) and the specified image format (e.g., .png).

using System;
using System.Windows.Forms;
using System.Drawing.Imaging;
using DevExpress.XtraMap;
using System.Diagnostics;

namespace ExportSelectedItems {
    public partial class Form1 : Form {
        string mapPath = "Image.png";

        public Form1() {
            InitializeComponent();
            mapControl1.ExportMapItem += mapControl1_ExportMapItem;
        }

        private void mapControl1_ExportMapItem(object sender, ExportMapItemEventArgs e) {
            if (!e.IsSelected)
                e.Cancel = true;
        }

        private void simpleButton1_Click(object sender, EventArgs e) {
            mapControl1.ExportToImage(mapPath, ImageFormat.Png);
            Process.Start(mapPath);
        }
    }
}
See Also