ArcGIS Engine Developer Guide

BUILDING APPLICATIONS WITH C++ AND CONTROL WIDGETS
6. To increase code readability, use a helper function FormSetup. You will need to
pass in an XtAppContext, which will be set in that function, as well as the
parameters passed into main.
a. First, place a definition of this file in MapViewer.h. You will also need to
inform the compiler where to find the Resize function, which you will be
using in FormSetup().
#include
For the equivalent GTK setup, see
form_setup in the provided MapViewer.cpp
file in the GTK zip file. You will notice that the
GTK function names differ slightly from the
Motif ones. This is to maintain the programming
styles associated with each.
void FormSetup(int argc, char* argv[], XtAppContext* app_context);
extern "C" void XtResizeWidget(Widget, _XtDimension,
_XtDimension, _XtDimension);
#endif // __ENGINE_CONTROL_MOTIF_EXAMPLE__
b. After initialization in MapViewer.cpp, call FormSetup, which you will write
in the following steps.
::AoInitialize(NULL);
{
…
}
XtAppContext app_context;
FormSetup(argc, argv, &app_context);
7. In MapViewer.cpp, after the main function, begin writing FormSetup by setting
the language procedure for your application.
void FormSetup(int argc, char* argv[], XtAppContext* app_context)
{
XtSetLanguageProc(NULL,NULL,NULL);
}
8. Continuing in FormSetup, create the Motif form for the MapViewer.
a. Initialize the Motif toolkit and create your top-level application Motif
widget.
XtSetLanguageProc(NULL,NULL,NULL);
// Initialize the Motif toolkit and create the parent widget
Widget topLevel = XtVaAppInitialize(app_context, "XApplication", NULL,
0, &argc, argv, NULL, NULL);
XtVaSetValues(topLevel, XmNtitle, "MapViewer", NULL);
b. Set the application’s initial size to 800 x 640, using the resize function that
you placed in MapViewer.h earlier.
XtVaSetValues(topLevel, XmNtitle, "MapViewer", NULL);
// Set the application size by resizing the created widget
XtResizeWidget(topLevel, 800, 640, 1);
c. Create the main application window after the resize. Create the main form
and attach it to the main window so that it fills the window. The main form
widget will be the parent widget for each of the ESRI Engine Control
widgets.
362 • ArcGIS Engine Developer Guide