Exceptions Dialog Box (Compact 2013)

  • Article

3/26/2014

Exceptions are anomolous or exceptional events during program execution that require special handling. This dialog box allows you to do the following:

  • Add an exception.
  • Modify the name of an exception.
  • Modify the debugger's response to an exception.

To display the dialog box, go to Debug > Exceptions.

This dialog box includes the following items.

  • Number
    Use to see the exception value of the selected exception.

    You can also type a user-defined exception value.

  • Name
    Use to see the name that the IDE displays for this exception value.

    You can also type a user-defined name.

  • Stop always
    Select to have exceptions reported individually and stop debugging.

    The debugger stops the run-time image and informs the user that the exception occurred.

    The user must then restart the run-time image manually by pressing the F5 key, or choosing Start from the toolbar, or select the Debug, then Start menu items.

  • Stop if not handled
    Select to have exceptions reported in the Output window and then continue debugging.

    The debugger notifies the user with a string in the Output window and continues debugging on the target device.

  • Exceptions
    Use to see all exceptions, both system-generated and user-defined.

    Select the exception you want to change and it will appear in the text boxes at the top of the dialog box.

    The list in this text box shows the following:

    • The exception value
    • The exception name
    • How the debugger responds to the exception

    Exceptions that do not appear in this exceptions list are reported as unnamed exceptions. The debugger stops for these exceptions.

  • OK
    Use to save your input and close the dialog box.
  • Cancel
    Use to close the dialog box without saving changes.
  • Add
    Use to add a new exception that you have typed in the text boxes.
  • Remove
    Use to remove the selected exception.
  • Change
    Use to add the changes you made to the selected exception in the exception list.
  • Reset
    Use to return all values to what they were before you opened this dialog box.

See Also

Concepts

Platform Builder User Interface

Other Resources

Platform Builder Dialog Boxes