This document is archived and information here might be outdated.  Recommended version.


IMapControl2 Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Controls > ESRI ArcGIS Controls > Interfaces > IM > IMapControl2 Interface
ArcGIS Developer Help

IMapControl2 Interface

Provides access to members that control the MapControl. Note: the IMapControl2 interface has been superseded by IMapControl4. Please consider using the more recent version.

Product Availability

Available with ArcGIS Engine.

Description

The IMapControl2 interface is a starting point for any tasks related to the MapControl, such as setting general appearance, setting map and display properties, adding and managing data layers and map documents, and drawing and tracking shapes.
 

Members

Name Description
Method AboutBox Displays a dialog of information about the MapControl.
Read-only property ActiveView The active view of the Map contained by the MapControl.
Method AddLayer Adds a layer to the Map's collection of layers at the specified index position.
Method AddLayerFromFile Loads a layer file and adds it to the Map's collection of layers at the specified index position.
Method AddShapeFile Adds a shapefile as a layer to the Map.
Read/write property Appearance The appearance of the MapControl.
Read/write property BackColor Background color of the MapControl.
Read/write property BorderStyle The border style of the MapControl.
Method CenterAt Moves the center of the MapControl to the specified location.
Method CheckMxFile Checks the specified filename to see if it is a map document that can be loaded into the MapControl.
Method ClearLayers Removes all layers from the Map.
Read/write property CurrentTool Current active tool for the MapControl. Set to nothing to clear the tool.
Method DeleteLayer Removes a Layer from the Map's collection of layers at the specified index position.
Method DrawShape Draws a geometry shape on the MapControl.
Method DrawText Draws text along the supplied geometry.
Read/write property Enabled Indicates whether the MapControl can respond to user generated events.
Read/write property Extent Current extent of the Map in map units.
Method FlashShape Flashes a shape on the MapControl, duration is in milliseconds.
Method FromMapPoint Converts a point on the Map (in map units) to device co-ordinates (typically pixels).
Read/write property FullExtent Rectangular shape that encloses all features of all layers in the Map.
Read-only property hWnd Handle to the window associated with the MapControl.
Read-only property Layer Layer at the supplied index.
Read-only property LayerCount Number of layers in the Map.
Method LoadMxFile Loads the specified Map from the map document into the MapControl. The Map can be an index or a name, if it is not supplied the focus map is used.
Read/write property Map The Map contained by the MapControl.
Read/write property MapScale Scale of the map as a representative fraction.
Read/write property MapUnits The geographical units of the map.
Read/write property MouseIcon Custom mouse icon used if MousePointer is 99.
Read/write property MousePointer The mouse pointer displayed over the MapControl.
Method MoveLayerTo Moves a layer within the Map's collection from its current index position to a new index position.
Read/write property OleDropEnabled Indicates if the MapControl will fire events when data is dragged over the control's window.
Method Pan Tracks the mouse while panning the MapControl.
Method ReadMxMaps Opens a map document specified by the supplied filename and reads the maps into an array object.
Read/write property ReferenceScale Reference scale of the Map as a representative fraction.
Method Refresh Redraws the Map, optionally just redraw specified phases or envelope.
Read/write property Rotation Determines how many degrees the map display is rotated.
Read/write property ShowScrollbars Indicates whether or not the Map's scrollbars are visible.
Read/write property SpatialReference Spatial reference of the Map.
Method ToMapPoint Converts a point in device co-ordinates (typically pixels) to a point on the Map (in map units).
Read/write property TrackCancel The object used by the MapControl to check if drawing has been aborted.
Method TrackCircle Rubber-bands a circle on the MapControl.
Method TrackLine Rubber-bands a polyline on the MapControl.
Method TrackPolygon Rubber-bands a polygon on the MapControl.
Method TrackRectangle Rubber-bands a rectangle on the MapControl.
Write-only property VisibleRegion The geometry specifying the visible region of the Map.

Classes that implement IMapControl2

Classes Description
MapControl Esri MapControl

.NET Samples

Geoevents in a MapControl