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


MapControl Class (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Controls > ESRI ArcGIS Controls > Classes > M > MapControl Class
ArcGIS Developer Help

MapControlClass Class

Esri MapControl

Product Availability

Available with ArcGIS Engine.

Description

The MapControl encapsulates the Map CoClass and provides additional properties, methods and events for: managing the general appearance, display properties and map properties of the control; adding and managing data layers within the control; loading map documents into the control; dropping data onto the control from other applications; and tracking shapes and drawing to the display.

Extended Error Information

Use the ISupportErrorInfo method InterfaceSupportsErrorInfo to determine if the object supports extended error information. If the object supports extended error info, VC++ developers should use the OLE/COM IErrorInfo interface to access the ErrorInfo object. Visual Basic developers should use the global error object Err to retrieve this extended error information.

Interfaces

Interfaces Description
IConnectionPointContainer (esriDisplay)
IMapControl2 Provides access to members that control the MapControl.
IMapControl3 Provides access to members that control the MapControl.
IMapControl4 Provides access to members that control the MapControl.
IMapControlDefault Provides access to members that control the MapControl.
IMapControlEvents2 Provides access to events that occur with interaction to the MapControl.
IMxdContents (esriCarto) Provides access to members to pass data into and out off a MXD map document file. Coclasses that implement this interface can limited the implementation to one property if required.
IPersist (esriSystem)
IPersistStreamInit (esriGeoDatabase)
ISupportErrorInfo (esriSystem)
ITOCBuddy Provides access to members that control the TOC buddy.
ITOCBuddyEvents Provides access to events that notify the TOC of a change.
IToolbarBuddy Provides access to members that control the ToolbarControl buddy.

Remarks

The MapControl uses a ScreenDisplay as the display object for drawing and will therefore react to the same keyboard and mouse actions as the ScreenDisplay object. 

There is no need to declare the MapControl's outbound interface as described below in most development environments, because the interface is automaticlly implemented.