Compiling and Testing with the GISDK Toolbar

 

The Tools>GIS Developer's Kit>GISDK Toolbar command toggles the GISDK toolbar, which contains tools you use to compile and test GISDK applications:

 

Tool	Function
	Compile resource file(s) to the default UI Database
	Test a macro or dialog box
	Compile resource file(s) to a stand-alone UI Database
	Start the GISDK Debugger
	Execute one or more Caliper Script statements immediately

 

The button compiles resources into a UI Database named test_ui. When you compile a resource file (or several resource files in a list file) using the button, first the test_ui database is cleared, and then the compiled resources are added to that database.

 

The button tests a resource that you compiled into the test_ui database. You specify the name of the resource to run, and whether it is a macro or a dialog box.

 

The button lets you choose the UI Database in which to store the compiled resouces. The database you choose is cleared, and then the compiled resources are added to the database.

 

The button starts the GISDK Debugger, which helps you find and fix runtime problems in GISDK macros. You can set breakpoints in resource files, see the call stack, see the values of variables, and set up a watch list. The GISDK Debugger runs along side Maptitude, in a separate window.

 

The button lets you type Caliper Script commands into a dialog box and have them executed immediately. This is often helpful when you are testing or debugging your GISDK programs. For more information, see Using Immediate Execution.

 

To Show the GISDK Toolbar

1. Choose Tools>GIS Developer's Kit>GISDK Toolbar. Maptitude shows the GISDK toolbar.
2. When you are done with the GISDK toolbar, choose Tools>GIS Developer's Kit>GISDK Toolbar again or click the Close box in the upper-right corner of the toolbar. Maptitude hides the GISDK toolbar.

To Compile a Resource File into the Default UI Database

1. Click on the GISDK toolbar to display the Compile dialog box.
2. Choose the file to compile and click OK.

GISDK compiles the resource file into the test_ui database. If any errors are encountered, the compiler creates an error file and displays a message.

 

To Compile a List of Resource Files into the Default UI Database

1. Click on the GISDK toolbar to display the Compile dialog box.
2. Choose the file containing a list of resource file names to compile and click OK.

GISDK compiles the resource files into the test_ui database. If any errors are encountered, the compiler creates error files and displays a message.

 

To Test a Resource in the Default UI Database

1. Click on the GISDK toolbar to display the Test an Add-In dialog box.
2. Choose the type of add-in that you are testing from the Type of Add-In radio buttons, Macro or Dialog Box.
3. Type the name of the resource you want to test, and click OK.

GISDK tests the resource you chose. If you want to test a resource where there is interaction with a map or other window, such as clicking to select a map feature, you will need to compile the resource file into a custom UI Database, install it as an add-in, and run it from the Add-Ins dialog box.

 

To Compile a Resource File into a Custom UI Database

1. Click on the GISDK toolbar to display the Compile dialog box.
2. Choose the file to compile and click OK. GISDK displays the Save As dialog box.
3. Type the name of the UI Database you want to create, and click OK.

GISDK compiles the resource file into the UI Database that you chose. If any errors are encountered, the compiler creates error files and displays a message.

 

To Compile a List of Resource Files into a Custom UI Database

1. Click on the GISDK toolbar to display the Compile dialog box.
2. Choose the file containing a list of resource file names to compile and click OK. GISDK displays the Save As dialog box.
3. Type the name of the UI Database you want to create, and click OK.

GISDK compiles the resource files into the UI Database that you chose. If any errors are encountered, the compiler creates error files and displays a message.