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


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

IMapControlDefault Interface

Provides access to members that control the MapControl.

Product Availability

Available with ArcGIS Engine.

Description

The IMapControlDefault interface is the default dispatch interface that most development environments will automatically expose. For example, placing the MapControl in a container will typically generate an object called MapControl1. The properties and methods available directly on this object correspond to this interface, together with container specific properties and methods.

The IMapControlDefault interface is a 'pure' dispatch interface, so can be extended with new properties and methods at future releases of ArcGIS. The methods and properties are identical to the highest numbered main interface on the MapControl. For example, IMapControlDefault is equivalent to IMapControl4, but at future releases this could become IMapControl5. By using the IMapControlDefault interface you are guaranteed to always have access to the latest MapControl.

There is a small performance overhead in making calls through to a pure dispatch interface, but to avoid this you can QI to a specific interface. In some development environments it is not possible to QI directly on the control to other COM interfaces, because the control is contained within a wrapper object. Use the Object property to get the real control before performing the QI.
 

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 AutoKeyboardScrolling Indicates whether keyboard scrolling is enabled.
Read/write property AutoMouseWheel Indicates whether the mouse wheel is enabled.
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.
Read/write property CustomProperty A property to associate data with a control.
Method DeleteLayer Removes a Layer from the Map's collection of layers at the specified index position.
Read/write property DocumentFilename The filename of the last map document loaded into the control.
Read/write property DocumentMap The name of the map that was last loaded into the control from a map document.
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/write property KeyIntercept A property that specifies interception of key strokes that are normally handled by the container. When intercepted the OnKeyDown and OnKeyUp events will be called. This value can be a combined bit mask of esriKeyIntercept enum values.
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-only property Object A property that returns the underlying control. This can be used when the control is inside a wrapper object that has been added by a development environment.
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 ShowMapTips Indicates if map tips are shown.
Read/write property ShowScrollbars Indicates whether or not the Map's scrollbars are visible.
Read/write property SpatialReference Spatial reference of the Map.
Method SuppressResizeDrawing Suppress full redraw of control during resize operations.
Read/write property TipDelay The delay before map tips are shown.
Read/write property TipStyle The style of map tips.
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 IMapControlDefault

Classes Description
MapControl Esri MapControl
[C#]

When querying interface to IMapControlDefault in Visual Basic .NET or Visual C# .NET the Object property or container specific code must be used. This is because .NET contains the real control inside a wrapper object known as an host.

IMapControlDefault mapControl = axMapControl1.Object as IMapControlDefault;

[Visual Basic .NET]

When querying interface to IMapControlDefault in Visual Basic .NET or Visual C# .NET the Object property or container specific code must be used. This is because .NET contains the real control inside a wrapper object known as an host.

Dim mapControl As IMapControlDefault = AxMapControl1.Object