Watch Window

Use the Watch window to specify variables that you want to monitor while debugging your application. The Watch list helps you keep track of variable type information and their values. It provides a convenient method of displaying different types of variable values on a single window while debugging your application.

The Watch window has the following elements:

Upward pointing arrow

Click the upward pointing arrow at the top right corner to undock the window from the Debug Console.

Downward pointing arrow

Click the downward pointing arrow at the top right corner to dock the window in the Debug Console.

Pop-up menu commands

Pop-up menu commands (right-click in Windows) are accessible from the colored header (docked window) or the first line below the window title (undocked window). The commands available are:

  • Dock - Docks a floating debug window inside the Debug Console. Command is disabled when a window is docked in the console.
  • Undock - Makes a docked debug window float outside the Debug Console. Command is disabled when a window is floating outside the console.
  • Hide - Closes an opened docked or floating window.

Variable

Variable name.

To add a variable to the Watch list, see "Adding a variable to the Watch list".

Types of variables you can monitor are:

  • local and global variables
  • package variables
  • form item vaues
  • variables in records and objects

To delete a variable from the list, select the variable by highlighting (single-clicking) it, then choose Remove from the pop-up menu (right-click in Windows).

To delete all variables in the list, choose Remove All from the pop-up menu (right-click in Windows).

Value

Current value for the variable. The value is updated as needed (and displays in red) when application execution is suspended at a different location. If suspension occurs in a program unit where the variable is not defined, #### displays in the cell instead of a value.

If the variable is read-only, the entire cell is highlighted when you try to edit it. If the variable is modifiable, only the value in the cell is highlighted when you select it.

To edit a value, click inside the cell and type a new value. Press the Enter key to set the new value. If you enter an invalid value, a message box appears allowing you to change the value or revert to the original value.



Hide and Show a Debug Window

Hide and Show the Debug Console

Resize a Debug window in the Debug Console

Resize Columns in a Debug Window

Undock and Dock a Debug Window