ArcGIS Engine Developer Guide

VISUAL C++
// Code to set the Buddy property of the TOCControl to be the MapControl
// Get a pointer to the PageLayoutControl and TOCControl.
IPageLayoutControlPtr ipPageLayoutControl;
GetDlgControl(IDC_PAGELAYOUTCONTROL1, IID_IPageLayoutControl, (void**)
&ipPageLayoutControl);
ITOCControlPtr ipTOCControl;
GetDlgControl(IDC_TOCCONTROL1, IID_ITOCControl, (void**) &ipTOCControl);
// Get the IDispatch of the PageLayoutControl.
IDispatchPtr ipBuddyDisp = ipPageLayoutControl;
// Set the TOCControls Buddy to the map control.
ipTOCControl->putref_Buddy(ipBuddyDisp);
8. To catch events from the controls, double-click the control on the form and
supply the name of a method to be called. By default, the wizard will add an
extra word “On” to the beginning of the event handler. Remove this to avoid
the event handler’s name from becoming “OnOnMouseDownMapcontrol1”.
The wizard will then automatically generate the necessary MFC sink map
macros to listen to events.
Adding controls to an MFC dialog box using IDispatch wrappers
As all ActiveX controls support IDispatch, this is the typical approach to add an
ActiveX control to an MFC project:
1. Click Project, click Add, then click Components and Controls.
2. Click Registered ActiveX Controls.
The design environment showing the
TOCControl, MapControl, and
ToolbarControl has been added to the
Controls toolbar and to the dialog box.
3. Double-click to select a control (for example, ESRI
TOCControl), then click OK to insert a component.
Click OK to generate wrappers. This will add a button
for the control to the Controls toolbar in Visual Studio.
4. Additional source files are added to your project (for
example, toccontrol.cpp and toccontrol.h). These files
contain a wrapper class (for example, CTOCControl) to
provide methods and properties to access the control.
This class will invoke the control through the IDispatch
calling mechanism. Note that IDispatch does incur some
performance overhead to package parameters when
making method and property calls. The wrapper class
inherits from an MFC CWnd class that hosts an ActiveX
control.
5. Repeat steps 1 through 4 to add each control to the
project’s Controls toolbar.
6. Choose a control from the Controls toolbar and drag it
onto the dialog box.
7. Right-click the control and click Properties. This will allow design-time
properties to be set on the control. NOTE: In Visual Studio C++, you cannot
set the Buddy property of the TOCControl and the ToolbarControl.
Chapter 4 • Developer environments • 127