Debug program tabs

The tabs beneath the toolbar determine the contents of the main window.


Source code

This is the default tab. It displays the source code for the selected source file, Initially this is the main program file. All other files included in the source code are listed in the File/Record listbox, from which they may be selected.

The display changes automatically to the correct source file when a breakpoint occurs.

A right-mouse click opens a menu with options to add a line break, remove all line breaks or remove all breaks. See Breakpoints.

Move the mouse over the name of a field to display its current value in a tooltip. If the field is subscripted, then, unless the element is included in the field name (e.g. tmp.ListArray[5]), the value of the first element is displayed.

Move the mouse over an identifier to display its type and long name in a tooltip. This is particularly useful with windows and window objects.


Functions

Displays all functions in the program in alphabetical order.

A right-mouse click opens a menu with options to add a function break, remove all function breaks or remove all breaks. See Breakpoints.

The right-mouse menu also contains an option to display the function in the source code window.


Fields

Displays all fields in the selected File/Record. This may be any of the following:

Sculptor system variables (sys.)

User-defined temporary variables (!temp)

Automatically assigned report variables (!auto)

Fields in temporary record structures (!record)

Fields in Sculptor keyed files (![o]file)

A right-mouse click opens a menu with an option to add a field to the Watched fields list.

The current value of a field can be determined by moving the mouse over its name in the source code window.


Call stack

Displays the current stack of function calls. Not yet implemented.


Settings

Display or change debug settings. The settings are specific to the current program. Changes made to the settings are effective immediately, but are not saved for future sessions unless the Save button is pressed.

Save Function Breaks on Exit

If this box is checked, the current function breakpoints will be saved when the program exits. Note that this applies to function breakpoints only; line breakpoints cannot be saved.

Slow Step Interval

The interval, in milliseconds, between steps when the program is run in slow motion. The default value is 500.

Skip Events

Events that are ticked will be skipped during the debug session. This is particularly useful for the EV_GAIN_FOCUS and EV_MOUSE_OVER events which interfere with normal debugging. These two events are therefore selected by default.

If Skip Event Function Break Only is selected, a function breakpoint on an event function is skipped for a ticked event, but a line breakpoint or a breakpoint on a non-event function is still processed.

If Skip All Breaks During Event is selected, all function and all line breakpoints are skipped during the current event.

The skip events feature is designed for skipping simple event functions that operate at a low level and don’t normally have sub-events.

Note, however, the behaviour that is used when a nested event does temporarily change the current event. A breakpoint in a nested event that is not set to be skipped will not be skipped until the nested event returns to the parent event, for which breakpoints are being skipped

Defaults

Select Sculptor’s default debug settings.

Restore

Restore the last saved settings for this program.

Save

Save the current settings for future sessions.


RELATED TOPICS

The Sculptor debug program