ArcGIS Engine Developer Guide

BUILDING APPLICATIONS WITH ACTIVEX
Loading map documents into the PageLayoutControl and
MapControl
Individual data layers or preauthored ESRI map documents can be loaded into
the MapControl and PageLayoutControl. You can either load the sample map
document provided or you can load your own map document. Later you will add
a dialog box to browse to a map document.
1. Double-click the form to display the code window.
2. Click the Form_Load event and enter the following code. (If you are using
your own map document, substitute the filename.)
Private Sub Form_Load()
' Check and load a preauthored map document into the PageLayoutControl
using relative paths.
Dim sFileName As String
sFileName = "..\..\..\..\..\..\Data\ArcGIS_Engine_Developer_Guide\Gulf
of St. Lawrence.mxd"
If PageLayoutControl1.CheckMxFile(sFileName) Then
PageLayoutControl1.LoadMxFile sFileName
End If
End Sub
3. Click the PageLayoutControl_ OnPageLayoutReplaced event and enter the
following code to load the same map document into the MapControl. The
OnPageLayoutReplaced event will be triggered whenever a document is
loaded into the PageLayoutControl.
Private Sub PageLayoutControl1_OnPageLayoutReplaced(ByVal newPageLayout
As Variant)
' Load the same preauthored map document into the MapControl.
MapControl1.LoadMxFile PageLayoutControl1.DocumentFilename
' Set the extent of the MapControl to the full extent of the data.
MapControl1.Extent = MapControl1.FullExtent
End Sub
Setting the TOCControl and ToolbarControl buddy controls
For the purpose of this application, the TOCControl and ToolbarControl will
work in conjunction with the PageLayoutControl rather than the MapControl. To
do this the PageLayoutControl must be set as the buddy control. The
TOCControl uses the buddy’s ActiveView to populate itself with maps, layers,
and symbols, while any command, tool, or menu items present on the
ToolbarControl will interact with the buddy control’s display.
1. Double-click the form to display the code window.
286 • ArcGIS Engine Developer Guide