com.esri.arcgis.controls
Interface IMapControl4

All Superinterfaces:
IMapControl2, IMapControl3, Serializable
All Known Implementing Classes:
IMapControl4Proxy, MapControl

public interface IMapControl4
extends IMapControl3, Serializable

Provides access to members that control the MapControl.

Description

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

Product Availability

Available with ArcGIS Engine.


Method Summary
 boolean isAutoKeyboardScrolling()
          Indicates whether keyboard scrolling is enabled.
 boolean isAutoMouseWheel()
          Indicates whether the mouse wheel is enabled.
 void setAutoKeyboardScrolling(boolean enabled)
          Indicates whether keyboard scrolling is enabled.
 void setAutoMouseWheel(boolean enabled)
          Indicates whether the mouse wheel is enabled.
 
Methods inherited from interface com.esri.arcgis.controls.IMapControl3
getCustomProperty, getDocumentFilename, getDocumentMap, getKeyIntercept, getObject, getTipDelay, getTipStyle, isShowMapTips, setCustomProperty, setDocumentFilename, setDocumentMap, setKeyIntercept, setShowMapTips, setTipDelay, setTipStyle, suppressResizeDrawing
 
Methods inherited from interface com.esri.arcgis.controls.IMapControl2
aboutBox, addLayer, addLayerFromFile, addShapeFile, centerAt, checkMxFile, clearLayers, deleteLayer, drawShape, drawText, esri_isEnabled, esri_setEnabled, flashShape, fromMapPoint, getActiveView, getAppearance, getBackColor, getBorderStyle, getCurrentTool, getExtent, getFullExtent, getHWnd, getLayer, getLayerCount, getMap, getMapScale, getMapUnits, getMouseIcon, getMousePointer, getReferenceScale, getRotation, getSpatialReference, getTrackCancel, isOleDropEnabled, isShowScrollbars, loadMxFile, moveLayerTo, pan, readMxMaps, refresh, setAppearance, setBackColor, setBorderStyle, setCurrentToolByRef, setExtent, setFullExtent, setMapByRef, setMapScale, setMapUnits, setMouseIconByRef, setMousePointer, setOleDropEnabled, setReferenceScale, setRotation, setShowScrollbars, setSpatialReferenceByRef, setTrackCancelByRef, setVisibleRegion, toMapPoint, trackCircle, trackLine, trackPolygon, trackRectangle
 

Method Detail

isAutoMouseWheel

boolean isAutoMouseWheel()
                         throws IOException,
                                AutomationException
Indicates whether the mouse wheel is enabled.

Description

Determines whether the mouse wheel can be used to zoom in and zoom out of the control's display. This property is true by default.

Product Availability

Available with ArcGIS Engine.

Returns:
The enabled
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setAutoMouseWheel

void setAutoMouseWheel(boolean enabled)
                       throws IOException,
                              AutomationException
Indicates whether the mouse wheel is enabled.

Product Availability

Available with ArcGIS Engine.

Parameters:
enabled - The enabled (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isAutoKeyboardScrolling

boolean isAutoKeyboardScrolling()
                                throws IOException,
                                       AutomationException
Indicates whether keyboard scrolling is enabled.

Description

Determines whether the 'Home' (keyCode 36), 'End' (keyCode 35), 'Page Down' (keyCode 34), 'PageUp' (keyCode 33) and 'Arrow' (keyCode 37-40) keys on the keyboard can be used to pan around the control's display. This property is true by default.

Most development environments use the 'Arrow' keys to switch focus between the controls embedded in a form or container. In such environments the MapControl will not by default receive the 'Arrow' keys to pan the display. To ensure 'Arrow' keys are received by the MapControl the KeyIntercept property must be set to intercept the 'Arrow' keys in order to pan the display when AutoKeyboardScrolling is true.

Product Availability

Available with ArcGIS Engine.

Returns:
The enabled
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setAutoKeyboardScrolling

void setAutoKeyboardScrolling(boolean enabled)
                              throws IOException,
                                     AutomationException
Indicates whether keyboard scrolling is enabled.

Product Availability

Available with ArcGIS Engine.

Parameters:
enabled - The enabled (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.