ArcGIS Engine Developer Guide

BUILDING APPLICATIONS WITH C++ AND CONTROL WIDGETS
The code shown in gray has already been
entered in previous steps. It is given here to
illustrate the accurate placement of the code you
are adding in this step.
For GTK you will need to replace the Motif
headers with a single include of gtk/gtk.h.
#endif
// __ENGINE_CONTROL_MOTIF_EXAMPLE__
2. Include the necessary files for the Motif toolkit. Make sure that String, Cursor,
Object, and ObjectClass have all been defined as ESRI types, as shown
below:
#define __ENGINE_CONTROL_MOTIF_EXAMPLE__
// Motif Headers
#define String esriXString
#define Cursor esriXCursor
#define Object esriXObject
#define ObjectClass esriXObjectClass
#include
#include
#include
#include
#undef String
#undef Cursor
#undef Object
#undef ObjectClass
#endif // __ENGINE_CONTROL_MOTIF_EXAMPLE__
3. Include the Engine C++ API header file:
#undef ObjectClass
// ArcObjects Headers
Although the names are similar, AoInitialize()
and the IAoInitialize interface have different
purposes. While AoInitialize() is a C++ API call
that initializes libraries, the IAoInitialize
interface is used to handle licensing for the
application.
// Engine
#include
4. Open MapViewer.cpp, a new file, in your text editor to implement your
application. Include the MapViewer.h file just created.
#include "MapViewer.h"
5. Begin writing the main function. First initialize the ArcGIS Engine with
AoInitialize, then set up the licensing for the product using IAoInitialize >
Initialize(). If a user attempts to run the application without an appropriate
ArcGIS Engine runtime or license, the application will exit. Notice that the
scope is set to prevent ipInit from existing when ::AoUninitialize() is called
later.
int main (int argc, char* argv[])
{
// Initialize the engine
::AoInitialize(NULL);
{
IAoInitializePtr ipInit(CLSID_AoInitialize);
esriLicenseStatus status;
ipInit->Initialize(esriLicenseProductCodeEngine, &status);
if (status != esriLicenseCheckedOut)
AoExit(0);
}
}
Chapter 6 • Developer scenarios • 361