ArcGIS Engine Developer Guide

BUILDING APPLICATIONS WITH C++ AND CONTROL WIDGETS
Customizing the ToolbarControl
In addition to adding Controls commands to the ToolbarControl programmatically,
you can also add them at runtime by customizing the ToolbarControl using the Customize
dialog box. To do this, you will place the ToolbarControl in customize mode
and display the Customize dialog box.
1. You will place a toggle button next to the ToolbarControl to turn the toolbar
customization mode on and off. To follow Motif standards, you will create a new
panel for the top of the screen, and it will hold both the ToolbarControl and the
toggle button.
a. First, include Xm/ToggleB.h in MapViewer.h.
Note that only tools and commands that are
registered on the system as COM components
can be added to the toolbar using the Customize
dialog box. Custom C++ commands and
tools, such as the one built in the previous step,
do not appear in the Customize dialog box, as
they are not registered as COM components in
the system registry.
The GTK toggle button’s setup is shown in the
GTK MapViewer.cpp’s form_setup.
#include
#include
#undef String
b. In MapViewer.cpp, add declarations for the toggle button widget. Also declare
the ICustomizeDialog interface pointer.
IEnvelopePtr g_ipCurrentExtent;
ICustomizeDialogPtr g_ipCustomizeDialog;
AddDateTool* g_dateTool;
Widget g_customizeToggle;
c. In FormSetup, create the toggle button (after mainForm is created) that will allow
you to customize the toolbar as well as its panel. Update the widget attachments
to reflect the new panel, replacing the location of the ToolbarControl.
// Create a sub-form to place ToolbarControl and customizeToggle on
Widget topFormPanel = XtVaCreateWidget("topformpanel",
xmFormWidgetClass, mainForm,
XmNtopAttachment, XmATTACH_FORM,
XmNrightAttachment, XmATTACH_FORM,
XmNleftAttachment, XmATTACH_FORM,
Chapter 6 • Developer scenarios • 401