Using the GISDK Debugger

Once you have set breakpoints and started running macros in a UI Database, execution will halt when a breakpoint is encountered and focus will shift to the GISDK Debugger. Most commands for controlling execution are on the Debug menu. Buttons on a dockable toolbar and keyboard shortcuts are alternate ways to use these commands. Here are the things you can do:

Button	Name	Shortcut	What it does
$image\ebx_-494515775.gif$	Show Current Statement	(none)	Highlights the currently executing statement. Not on theDebugmenu.
$image\ebx_638005127.gif$	Step Into	F11	Continues execution to the next statement. If the current statement contains a RunMacro or RunDBox call, then execution stops at the first statement of the macro being called (Init macro for RunDBox).
$image\ebx_-2016486612.gif$	Step Over	F10	Continues execution to the next statement in the current macro, after executing any macro that is called from the current statement.
$image\ebx_249638609.gif$	Step Out	Shift+F11	Completes execution of the current macro and breaks at the next statement in the macro that called the current macro.
$image\ebx_-494146639.gif$	Run to Cursor	Ctrl+F10	Continues execution until the statement containing the cursor.
$image\ebx_1382861346.gif$	Jump to Cursor	Shift+Ctrl+F10	Sets the line containing the cursor as the next line to be executed. This is only enabled if the cursor is in the current macro.
$image\ebx_892502405.gif$	Go	F5	Continues execution until the next breakpoint, if any.
$image\IMG00002.gif$	Toggle Breakpoint	F9	Adds a breakpoint at the line containing the cursor, or removes the breakpoint if one already exists for that line.

There are also commands for finding the current statement, text, lines, or first statements in macros and dialog boxes, for managing the breakpoints and watch list, and for editing values of variables and sub-elements of arrays or compound variables.

The source file must be the same version as the one compiled into the UI Database. If there is a mismatch between file versions, you will need to recompile the UI Database with the file you want to use.

You cannot step into or out of macros in different UI Databases unless you have explicitly set a breakpoint in a source file for the other UI Database.

To Use the GISDK Debugger

Start a macro or dialog box. When execution reaches a breakpoint, focus will shift to the GISDK Debugger program window. A yellow arrow will be pointing to the current statement.
Control execution as follows:

To do this...	Do this...
Continue execution to the next statement	Click $image\ebx_638005127.gif$ , chooseDebug-Step Into, or press F11. If the current statement contains a RunMacro or RunDBox call, then execution stops at the first statement of the macro being called (Init macro for RunDBox).
Continue execution to the next statement in the current macro	Click $image\ebx_-2016486612.gif$ , chooseDebug-Step Over, or press F10.
Complete execution of the current macro	Click $image\ebx_249638609.gif$ , chooseDebug-Step Out, or press Shift+F11. Execution halts at the next statement in the macro that called the current macro.
Continue execution until the statement containing the cursor	Click on a line in the source code window, then click $image\ebx_-494146639.gif$ , chooseDebug-Run to Cursor, or press Ctrl+F10.
Set the line containing the cursor as the next line to be executed	Click on a line in the source code window, then click $image\ebx_1382861346.gif$ , chooseDebug-Jump to Cursor, or press Shift+Ctrl+F10. This is only enabled if the cursor is in the current macro.
Continue execution until the next breakpoint, if any	Click $image\ebx_892502405.gif$ , chooseDebug-Go, or press F5.

Do other things as follows:

To do this...	Do this...
Find the current statement	Click $image\ebx_-494515775.gif$ . The GISDK Debugger highlights the currently executing statement in a source code window, which will be brought to the front and scrolled if necessary.
Find some text in the current source code window	ChooseEdit-Findto display the Find dialog box, type the text in the edit box, and click Find Next. Click Find Next again to find the next occurrence. Use the Direction radio buttons to control the search direction. Check the Match Case box to match upper and lower case exactly. Click Cancel or the close box to close the Find dialog box.
Go to a line in the current source code window	ChooseEdit-Go to Lineto display the Go to Line dialog box, type the line number in the edit box, and click OK.
Find the first statement in a specific macro or dialog box	ChooseEdit-Find Macro/Dboxto display the Find Macro/Dbox dialog box, type the name of the macro or dialog box in the edit box, click the Macro or Dbox radio button, and click OK. The first statement for a dialog box will be in the Init macro.
Find the current statement for a macro in the call stack	Double-click an item in the Call Stack window.
Find a breakpoint	Double-click an item in the Breakpoints window.
Toggle a breakpoint	Click on a line in the source code window, then click $image\IMG00002.gif$ , chooseDebug-Toggle Breakpoint, or press F9. If the line is already a breakpoint, the breakpoint is removed. You can also remove a breakpoint by highlighting the breakpoint in the Breakpoints window and pressing Del or Backspace.
Expand and collapse arrays and compound variables	Click a plus icon to expand or a minus icon to collapse a portion of the array or compound variable in the Variable or Watch window.
Display an array as an options array	Right-click on the options array name and chooseDisplay as Options Array. Remove the check by choosingDisplay as Options Arrayto display the array as a regular array.
Add a variable to the watch list	Highlight the variable in the Variable window, right-click and chooseAdd Watch. The variable appears in the Watch window.
Change the value of a variable	Highlight the variable (or the sub-element of an array or a compound variable) in the Variable window, right-click and chooseEdit Valueto display the Watch Expression dialog box. Edit the value in the edit box and click OK. Note that character strings must be enclosed in quotes.
Add an item to the watch list	Right-click on the Watch window and chooseAdd Watchto display the Watch Expression dialog box. Type an expression and click OK.
Edit an item in the watch list	Highlight a watch item in the Watch window, right-click and chooseEdit Expressionto display the Watch Expression dialog box. Edit the expression and click OK.
Remove an item from the watch list	Highlight a watch item in the Watch window and press the Del or Backspace key.
Remove all items from the watch list	Right-click on the Watch window and chooseDelete Allto display the Delete All dialog box. Click Yes to delete all the watch items, or No to keep them all.
Change the value of a watch item	Highlight the watch item in the Watch window, right-click and chooseEdit Valueto display the Watch Expression dialog box. Edit the value in the edit box and click OK. Note that character strings must be enclosed in quotes. The command is only enabled for variables and sub-elements of arrays or compound variables.

When you are done using the GISDK Debugger, choose File-Exit.

The GISDK Debugger program window closes, and macros run normally.