ArcGIS Engine Developer Guide

BUILDING APPLICATIONS WITH C++ AND CONTROL WIDGETS
They also use the Engine Developer Kit libraries:
• libarcsdk.so
• libmotifctl.so
• libaoctl.so
In addition, for Motif you must link against:
• libpthread.so (Linux only)
• libXm.so
• libX11.so
To implement a custom tool, you must include the following file:
• Ao/AoToolBase.h
IMPLEMENTATION
The implementation below provides you with all the code you will need to
successfully complete the scenario. It does not provide step-by-step instructions
for developing C++ applications with Motif, as it assumes that you have a working
knowledge of the development environment already.
During this scenario, the steps assume that you are programming on Solaris.
However, to follow this same scenario on Linux all you will need to do is to use
the Linux makefile, Makefile.LinuxMotif, instead of the Solaris makefile,
Makefile.SolarisMotif.
Makefiles greatly simplify the build process for
large applications. ESRI's Makefile samples don’t
always use all of the functionality available in the
make utility (for example, SUFFIXES and
pattern rules) because they are designed to
work across many different versions of make.
However, the makefiles do use various predefined
variables that are available for most
versions of make. These predefined variables
include both commands (for example, CXX and
RM) and command arguments (for example,
CXXFLAGS and LDFLAGS). Consult the documentation
for the make utility for more
information about its advanced features.
Creating the makefile
To easily compile the application you make use of a makefile. This scenario is not
designed to teach you the basics of project management with the make utility, so
if you are unfamiliar with them, please see the Oram and Talbott reference at the
end of this scenario.
1. To create the makefile for this scenario, copy either the
Makefile.SolarisMotif.Template (for Solaris programming) or
Makefile.LinuxMotif.Template (for Linux programming). Those files are
located with the code in the Motif_Cpp folder. Remove the “.Template” from
the end of the filename, and replace all instances of “motif_sample” with
“MapViewer.” The Makefile.SolarisMotif.Final and
Makefile.LinuxMotif.Final, in the same directory, show what your makefile
should look like at the end of this scenario.
Creating the Motif Application form by placing the ArcGIS Engine
controls on a Motif Application form
To use the controls, you must create them as Motif widgets and place them into a
Motif application form.
1. Open MapViewer.h, a new file, in your text editor. Place the following lines
to ensure that the class is only declared once. The remainder of code for this
file will fall between #define and #endif.
#ifndef __ENGINE_CONTROL_MOTIF_EXAMPLE__
#define __ENGINE_CONTROL_MOTIF_EXAMPLE__
360 • ArcGIS Engine Developer Guide