ArcGIS Engine Developer Guide

C++ APPLICATION PROGRAMMING INTERFACE
ARCGIS DEVELOPMENT IN THE VISUAL STUDIO 6.0 IDE
The ArcSDK.h and ArcGIS Engine OLB files are
installed in the \include\CPPAPI and \com folders, respectively.
Setting up your application
To begin creating your ArcGIS Engine application in Visual Studio 6.0, start
Microsoft Visual C++ and use the Win32 Console Application wizard to create
an empty project. Click File > New > Win32 Console Application, type in the
name of the project, and choose its location.
Next, set the required project options. On the C/C++ tab of the Project Menu >
Settings dialog box, click Preprocessor from the Category combo box. In the
Additional Include Directories text box, type the path to ArcSDK.h. In addition,
type in the location of the ArcGIS Engine OLB files. Don’t forget to separate the
two paths with a semicolon.
Go to the Preprocessor Definitions text box and type “ESRI_WINDOWS” to
define the ESRI_WINDOWS symbol. Similar to the include directories, symbols
need to be separated with commas.
It is recommended that you use the /GX and /NOLOGO compiler flags. /GX
enables synchronous exception handling, and /NOLOGO prevents display of a
compiler startup banner and informational compiler messages. Activate /GX by
opening the project Property Pages, navigating to C/C++ > C++ Language, and
checking Enable exception handling. Set /NOLOGO by checking the Suppress
Startup Banner and Information Messages option from the menu bar, Project >
Settings > C/C++ tab > Customize category.
Finally, go to Project > Add to Project > New to add some files to the project;
these will eventually contain your code. Select the type of file you want to add
and give it a name. Add as many files as you need for your application. You are
ready to write your code. Don’t forget to start by including ArcSDK.h!
Compiling your application
To compile an ArcGIS Engine application in Visual Studio 6.0, press F7 or click
Build > Build YourApplicationName.exe.
Running your application
Before you can run an ArcGIS Engine command-line application from within
Visual Studio 6.0, you need to set up the arguments. Arguments are added to your
program by customizing your project settings; go to the Project menu > Settings
> Debug tab and add any arguments to the Program arguments text box.
Once the arguments are added, run the application by clicking Build > Execute
YourApplicationName.exe or by pressing Ctrl+F5. To run the application in
debug mode, click Build > Start Debug > Go, or press F5.
ARCGIS DEVELOPMENT IN THE VISUAL STUDIO .NET 2003 IDE
Setting up your application
The easiest way to program with the C++ API in .NET is to use the C/C++
Console Application wizard. This wizard is not the same as the Win32 Console
Project and Console Application (.NET) wizards. To access the C/C++ Console
Application wizard, you must install Academic Tools for VS .NET 2003. This is
available from the downloads page at http://msdn.microsoft.com/academic/
Chapter 4 • Developer environments • 213