ArcGIS Engine Developer Guide

WORKING WITH THE ARCGIS CONTROLS
ArcGIS Desktop developers may already be
familiar with MapControl and
PageLayoutControl since these controls were
initially made available in previous ArcGIS
Desktop releases. With the release of ArcGIS
Engine, these controls have been incorporated
into its package of developer components. As in
previous releases, ArcGIS Desktop developers
can build applications with MapControl or
PageLayoutControl even without an ArcGIS
Engine license. However, they cannot work with
the additional controls provided with ArcGIS
Engine unless you have an Engine Developer Kit
license.
Deployment of applications built with either
GlobeControl or SceneControl requires both
a core ArcGIS license—Engine Runtime or
Desktop—and its corresponding 3D extension
license. For more information on deployment of
ArcGIS controls-based applications, see
Chapter 5, ‘Licensing and deployment’.
the control programmatically using the LoadMxFile method.
Not only can the MapControl and PageLayoutControl read map documents, they can
also write map documents. Both controls implement the IMxdContents interface
that enables the MapDocument object to write the contents of the MapControl and
PageLayoutControl to a new map document.
Helper methods, such as TrackRectangle, TrackPolygon, TrackLine, and TrackCircle,
exist on the MapControl for tracking or “rubberbanding” shapes on the display.
The VisibleRegion property can be used to change the shape of the MapControl’s
display area. Helper methods, such as FindElementByName and LocateFrontElement,
exist on the PageLayoutControl to help you manage elements, while the Printer and
PrinterPageCount properties, together with the PrintPageLayout method, assist with
printing tasks.
GLOBECONTROL AND SCENECONTROL
The GlobeControl and SceneControl correspond to the 3D views of the ArcGlobe
and ArcScene applications. The GlobeControl encapsulates the GlobeViewer object,
and the SceneControl encapsulates the SceneViewer object. Globe and Scene documents
authored with the ArcGlobe and ArcScene applications can be loaded into
the GlobeControl and SceneControl, respectively, to avoid programmatically composing
the cartography.
Both the GlobeControl and SceneControl have built-in navigation capability that
allows the end user to move around the 3D view and visualize the 3D data,
without having to use the available control commands or a custom command. To
use the built-in navigation, the Navigate property must be set either through the
property pages or programmatically. The end user can use the left mouse button
to navigate backward and forward
and to the left and right of
the display and use the right
mouse button to zoom in and
out on the display.
Applications built using the GlobeControl
and SceneControl, respectively
Chapter 3 • Developing with ArcGIS controls • 45