ArcGIS Engine Developer Guide

BUILDING APPLICATIONS WITH C++ AND CONTROL WIDGETS
5. Now that you have a working command, it can be incorporated into the
application.
a. Make the application aware of the new command by including AddDate.h
in MapViewer.h.
#include "MapControlEvents.h"
#include "AddDate.h"
b. Create an instance of the command at the top of MapViewer.cpp.
IEnvelopePtr g_ipCurrentExtent;
AddDateTool* g_dateTool;
c. The custom AddDate command will be added as the last item on the
toolbar. This is done using the AoToolbarAddTool C++ API function. Place
the call at the end of the AddToolbarItems function of MapViewer.cpp.
varTool = L"esriControlCommands.ControlsMapFullExtentCommand";
g_ipToolbarControl->AddItem(varTool, 0, -1, VARIANT_FALSE, 0,
esriCommandStyleIconOnly, &itemIndex);
// Add custom date placement command to the tools toolbar
g_dateTool = new AddDateTool();
AoToolbarAddTool(g_ipToolbarControl, g_dateTool,
esriCommandStyleIconOnly);
d. This instance of the tool must be deleted in CloseAppCallback.
delete g_mapEvents;
// delete the instance of the tool
delete g_dateTool;
6. Update the makefile. List AddDate.cpp as a source and create a dependencies
list for AddDate.o. Make sure that the MapViewer.cpp file’s dependency on
AddDate.h is reflected.
7. Remake and run the application. If you used the provided icon, there will be a
new button with a D, underlined twice, on the toolbar. Select your new tool
and click the PageLayoutControl to add a text element containing today’s
date.
400 • ArcGIS Engine Developer Guide