ArcGIS Engine Developer Guide

C++ APPLICATION PROGRAMMING INTERFACE
Trying it out
To compile your Motif program, you will need to link against libraries for Motif,
Xt, and X11, in that order. If you are programming on Solaris, you will compile
with the Sun Workshop (Forte), and if you are programming on Linux you will
use GCC.
CC pbExample.cpp -o pbExample -lXm -lXt -lX11
Run the program:
./pbExample
As you click the button, you will see counts appear in your terminal window.
Now that you have a feeling for Motif programming, look at the C++ samples
for Motif, and see these steps applied there.
Additional resources
• Heller, Dan, Paula M. Ferguson, and David Brennan. Motif Programming
Manual (The Definitive Guides to the X Window System, Volume 6A) 2nd
Edition. O’Reilly & Associates. 1994.
Motif ArcGIS control programming
The Solaris and Linux SDK also provides a set of Motif widgets that may be
used to embed the ArcGIS controls in a Motif application. Due to the limitations
of Motif, this code will only run on Solaris and Linux systems. If visual components
are needed on Windows, you will need to use Visual C++, the COM API,
and ActiveX controls.
Header files
To use the Motif ArcGIS controls, you will need to include both the ArcGIS
Engine header file, ArcSDK.h, and the ArcGIS Engine Motif controls header
file, Ao/AoMotifControls.h.
Control types and their details
Control
Globe Control
Map Control
PageLayout Control
Reader Control
Scene Control
TOC Control
Toolbar Control
MwNprogID
AoPROGID_GlobeControl
AoPROGID_MapControl
AoPROGID_PageLayoutControl
AoPROGID_ReaderControl
AoPROGID_SceneControl
AoPROGID_TOCControl
AoPROGID_ToolbarControl
Interface Type
IGlobeControl
IMapControl3
IPageLayoutControl
IARControl
ISceneControl
ITOCControl
IToolbarControl
API functions and arguments
• For each ArcGIS Engine Control interface, there is a smart pointer defined for
you. Instead of IMapControl3*, you can use IMapControl3Ptr.
• MwCtlAppMainLoop replaces XtAppMainLoop.
extern "C" void MwCtlAppMainLoop(XtAppContext app);
• MwCtlGetInterface is used to get the control’s interface pointer.
HRESULT MwCtlGetInterface(Widget w, IUnknown** ppUnk);
Chapter 4 • Developer environments • 239