Variables Window (Windows CE 5.0)
The Variables window provides quick access to variables that are important to the program's current context.
The following tabs appear in the Variables window.
| Tab | Description |
|---|---|
| Auto | Displays information about variables from the current statement and the previous statement.
Variables appear in alphabetical order. If a statement spans multiple lines, the Auto tab displays variables from the lines corresponding to that statement, up to a 10-line limit. |
| Locals | Displays the names, values, and types of all local variables in the current function.
As you trace through a program, new variables come into scope. |
| this | Displays type, name, and value information about the object pointed to by the pointer, this.
All base classes of the object are automatically expanded. |
Each tab contains a table with fields for the variable name and value. The debugger fills in these fields.
If a value appears in red, the value has recently changed. Only the last value to change appears in red.
You can right-click any tab to bring up a context menu of commands.
You can cut, copy, or drag information from the Variables window. You can edit the Value column to change the value of a variable while debugging.
If you selected hexadecimal display from the Options dialog box, which is accessed from the Tools menu, enter the value in hexadecimal or use the prefix 0n (zero-n) to indicate that the number is a decimal, such as 0n1000.
For more information, see Debug Tab.
You cannot add variables or expressions to the Variables window, but you can change the value of an existing variable by double-clicking the associated Value field and entering new data.
You can also expand or collapse the list of displayed variables by using the tree controls.
You can expand an array, an object, or a structure variable in the Variables window if it has a plus (+) box in the Name field. If an array, object, or structure variable has a minus (–) box in the Name field, the variable is fully expanded.
If the variable is an object, a reference, or a C++ pointer to an object, the Variables window expands the variable to show the most important data at the top level.
If the variable is a reference or a C++ pointer to an object, the Variables window downcasts the reference or pointer.
The Variables window adds an extra member to the expanded object. This extra member, which looks like another base class, indicates the derived subclass.
For example, if a variable declared as a C++ pointer to CObject points to a CComboBox, the Variables window recognizes this and adds an extra member so you can access the CComboBox members.
In addition to tabs, the Variables window has a context box on the toolbar that contains a copy of the current call stack in a drop-down list box. Use this list to specify the current scope of variables that are displayed.
You can hide the Context list by right-clicking in the Variables window and then clearing the Toolbar check box.
You can navigate to a function's source code or disassembled object code from the Context list. This procedure displays the function's source code, if available, in a source window. If source code for the selected function is not available, this procedure displays the function's object code in the Disassembly window.
To autosize a column to fit its contents, double-click the vertical divider at the column edge. To size a column manually, drag the right divider to the left or right.
Rows are sized to fit the current font and cannot be resized manually. To change the font size, use the Format tab of the Options dialog box. For more information, see Format Tab.
- Shortcut menu
Right-click the window to bring up a menu, which contains the following functions:Item Description Toolbar Hides the Variables window toolbar. Hexadecimal Display Changes the way integers are displayed: - Turn this option on to display all integers, both signed and unsigned, in hexadecimal.
- Turn this option off to display all integers in decimal.
Docking View Switches the active window from docking to nondocking mode. Docking mode. When a window is in docking mode, a check mark appears.
You can dock the window to the border of the main Platform Builder window, or you can change the window to a floating window that can be moved outside the main Platform Builder window.
To change the window to a floating window, hold the CTRL key and click on the frame of the window you select.
This window can be redocked at any time.
- Nondocking mode. If the window is in nondocking mode, it appears inside the main Platform Builder window only and cannot be docked.
Hide Hides the Variables window. Properties Opens the Program Variable Properties dialog box and displays the properties for the selected item.
See Also
Program Variable Properties Dialog Box | Viewing a Variable in the Variables Window
Send Feedback on this topic to the authors