ArcGIS Engine Developer Guide

WORKING WITH THE ARCGIS CONTROLS
If you are using JavaBeans, the buddy control can
only be set through code as this property is not
exposed in the integrated development environment
(IDE) property pages.
TOOLBARCONTROL
The ToolbarControl works in conjunction with a buddy control. The buddy control
can be a MapControl, PageLayoutControl, ReaderControl, SceneControl, or GlobeControl.
The buddy control can be set at design time through the ToolbarControl property
pages (in development environments that support property page capability) or
programmatically using the SetBuddyControl method when the container hosting
the ToolbarControl is displayed. The ToolbarControl hosts a panel of commands,
tools, tool controls, and menus that work with the display of the buddy control.
An application that uses the ToolbarControl
and the GlobeControl
To link a custom control that you have created
to the ToolbarControl the custom control
must implement the IToolbarBuddy interface.
Each ToolbarControl buddy control implements the IToolbarBuddy interface. This
interface is used to set the CurrentTool property of the buddy control. For example,
imagine a ToolbarControl that is hosting a Page Zoom In tool and has a
PageLayoutControl as its buddy. When the end user clicks on the Page Zoom In tool
on the ToolbarControl, it will become the CurrentTool of the PageLayoutControl. The
implementation of the Page Zoom In tool will query the ToolbarControl to access
its buddy control—the PageLayoutControl—and retrieve the PageLayout. It will
then provide the implementation for displaying the rectangle dragged by the end
user and changing the extent of the PageLayout.
CONTROL COMMANDS
ArcGIS Engine provides a set of commands, tools, and menus to work with the
ArcGIS controls. For example, there is a map navigation, feature selection, and
graphic element commands suite that works with the MapControl and
PageLayoutControl. Likewise, there is a suite of commands for the SceneControl,
GlobeControl, and ReaderControl. For applications using an individual control, these
commands can work directly with the control by programmatically creating a new
instance of the command and passing the control to the command’s OnCreate
event. For applications using the ToolbarControl in conjunction with a buddy
control, these commands can be added to the ToolbarControl either through the
Chapter 3 • Developing with ArcGIS controls • 47