ArcGIS Engine Developer Guide

BUILDING APPLICATIONS WITH C++ AND CONTROL WIDGETS
Rather than walk through this scenario, you can
get the completed application from the samples
installation location. The sample is installed as
part of the ArcGIS developer samples.
The ArcGIS developer samples are not included
in the typical installation of the ArcGIS Engine
Developer Kit. If you do not have them installed,
rerun the developer kit Install wizard, click
Custom or Modify, and click the samples feature
under Software Developer Kit.
Motif and GTK ArcGIS C++ control widgets are
only available on Solaris and Linux. However, GUI
applications can be built on Windows with the
COM API, including Visual C++, and the ActiveX
ArcGIS controls.
The scenario has also been implemented with
the GTK widget ArcGIS controls. That code can
be found in the ArcGIS Engine Developer Kit.
This scenario is designed to introduce the ArcGIS Engine C++ API Control
widgets. Its purpose is not to teach how to set up a C++ environment, how to
compile using the make utility, or how to program with the Motif toolkit.
Throughout this scenario it is assumed that the developer has a functional C++
environment and knows how to compile a C++ and Motif program in that
environment. What this scenario does provide are the steps to take and the code
to write to create a standalone ArcGIS controls application for viewing map
documents, complete with a popup menu and custom tool.
You can find this sample in /developerkit/samples/
Developer_Guide_Scenarios/Building_an_ArcGIS_Controls_Map_Viewer_
ApplicationMotif_Cpp.zip.
Although only C++ and Motif code samples are shown here, GIMP Toolkit
(GTK) C++ code has also been written and can be found at /
developerkit/samples/Developer_Guide_Scenarios/Building_an_ArcGIS_
Controls_Map_Viewer_ApplicationGTK_Cpp.zip.
PROJECT DESCRIPTION
The ‘Building applications with C++ and control widgets’ scenario demonstrates
the steps required to develop and deploy a GIS application using the standard
ArcGIS controls within the ArcGIS Engine C++ API. This scenario uses the
MapControl, PageLayoutControl, TOCControl, and ToolbarControl as Motif
widgets in code written using a standard text editor and compiled using the make
utility.
This scenario demonstrates the steps required to create a GIS application for
viewing preauthored ESRI map documents, or MXDs. The scenario covers the
following techniques:
• Programming with the ArcGIS Engine in a standard text editor
• Programmatically placing the ArcGIS Engine controls in Motif widget forms
• Loading preauthored map documents into the MapControl and
PageLayoutControl
• Setting ToolbarControl and TOCControl buddy controls
• Adding control commands and tools to the ToolbarControl
• Creating popup menus
• Managing label editing in the TOCControl
• Drawing shapes on the MapControl
• Creating a custom tool to work with the MapControl, PageLayoutControl,
and ToolbarControl
• Customizing the ToolbarControl
• Deploying the application on a Solaris or Linux platform
CONCEPTS
This scenario is implemented using a text editor, the make utility, and Motif
widget ArcGIS controls.
Chapter 6 • Developer scenarios • 357