ArcGIS Engine Developer Guide

BUILDING APPLICATIONS WITH WINDOWS CONTROLS
Customizing the ToolbarControl
In addition to adding ArcGIS Engine commands and tools to the ToolbarControl
in the Form_Load event, you can also add them by customizing the
ToolbarControl and using the Customize dialog box. To do this you will place the
ToolbarControl in customize mode and display the Customize dialog box.
1. Add the following member variables to the class:
Visual Studio .NET provides the ability to specify
functions that execute when an assembly
exposed for COM interop is registered and
unregistered on a system. This allows you to
register your class in a component category that
the Customize dialog box will look for.
The ComVisible attribute is set to false to
ensure that this method cannot be called directly
by a COM client. It does not affect the method
being called when the assembly is registered
with COM.
public class Form1 : System.Windows.Forms.Form
{
…
private ITransformEvents_VisibleBoundsUpdatedEventHandler
visBoundsUpdatedE;
private ICustomizeDialog m_CustomizeDialog = new
CustomizeDialogClass(); // The CustomizeDialog used by the
ToolbarControl
private ICustomizeDialogEvents_OnStartDialogEventHandler
startDialogE; // The CustomizeDialog start event
private ICustomizeDialogEvents_OnCloseDialogEventHandler
closeDialogE; // The CustomizeDialog close event
2. Create a new function called CreateCustomizeDialog. This is where you will
create the Customize dialog box by adding the following code to the function:
private void CreateCustomizeDialog()
{
// Set the customize dialog box events.
startDialogE = new
ICustomizeDialogEvents_OnStartDialogEventHandler(OnStartDialog);
((ICustomizeDialogEvents_Event)m_CustomizeDialog).OnStartDialog +=
startDialogE;
closeDialogE = new
ICustomizeDialogEvents_OnCloseDialogEventHandler(OnCloseDialog);
((ICustomizeDialogEvents_Event)m_CustomizeDialog).OnCloseDialog +=
closeDialogE;
// Set the title.
m_CustomizeDialog.DialogTitle = "Customize ToolbarControl Items";
// Show the Add from File button.
m_CustomizeDialog.ShowAddFromFile = true;
// Set the ToolbarControl that new items will be added to.
m_CustomizeDialog.SetDoubleClickDestination(axToolbarControl1);
}
3. Call the CreateCustomizeDialog function from the Form_Load event before
the call to the CreateOverviewSymbol subroutine.
private void Form1_Load(object sender, System.EventArgs e)
{
// Create the Customize dialog box for the ToolbarControl.
CreateCustomizeDialog();
}
// Create symbol used on the MapControl…
352 • ArcGIS Engine Developer Guide