ArcObjects Library Reference (Controls)

IMapControl4 Interface

Provides access to members that control the MapControl.

Product Availability

Available with ArcGIS Engine.

Description

The IMapControl4 interface provides additional members for tasks related to navigating the display of the MapControl using the keyboard and mouse.

Members

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

CoClasses that implement IMapControl4

CoClasses and Classes	Description
MapControl	Esri MapControl

[C#]

When querying interface to IMapControl4 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.

IMapControl4 mapControl=axMapControl1.Object as IMapControl4;

[Visual Basic .NET]

Dim mapControl As IMapControl4=AxMapControl1.Object

.NET Samples

GraphicTracker with the map (Code Files: AddGT SelectGT) | Implementing a property page for an ArcGIS Engine application (Code Files: FeatureLayerSymbology)