viewcommand

This command can be used to manipulate the data explorer. This command is event driven and therefore is only useful for mouse or key bindings.

Format: viewcommand cmds [=y[,x]] [press|release] [wid=num]

Requests a data explorer, monitor, or remote window to perform some action. The num is a window identification number obtained by the %w command. See "scrollcommand" for more information on num.

Much of the information needed for certain viewcommand's is dynamic and difficult to obtain, thus there are a few variables available which the debugger will automatically assign when a viewcommand is run. They can be used to dynamically assign some of these values:
Variables automatically assigned by the debugger
%m
If the event is a mouse button press or release, this will be replaced by the word press or release respectively.
%w
This will automatically be replaced with the window manager assigned identification number of the window in which the event took place.
%x
This will be replaced with the current mouse X-coordinate.
%y
This will be replaced with the current mouse Y-coordinate.
Examples
viewcommand IncrField=%y,%x %m wid=%w
viewcommand Pop wid=%w

For more examples, choose Config > Options... > General tab > Mouse Bindings... and look at the bindings in the Mouse Commands window.

The following is a list of cmds:
Values for cmds
Beep
The data explorer beeps to indicate an error. If no command matches a press, this is the default.
Noop
Does nothing. (Short for "No operation".)
EditType
Opens a dialog box to change the type of data displayed in the data explorer. This command needs a window number.
EditAddress
Opens a dialog box to change the address displayed by the data explorer. This command needs a window number.
AddVariable
Opens a dialog box to change the variable(s) displayed by the data explorer. This command needs a window number.
AddVarOrAdr
Opens a dialog box to change either the variables or the address displayed by the data explorer. This command needs a window number.
EditField
Opens a dialog box to change the value of a field, or element of an array. This command needs a y value and a window number.
IncrField
Increases the value of the field by the integer value one. This command needs a window number, x, y, and a press/release field.
DecrField
Decreases the value of the field by the integer value one. This command needs a window number, x, y, and a press/release field.
MakeArray
Changes the type of item displayed in an array of the current type. If the current type is an array, it makes a bigger one. This command needs a window number.
FindTypeAndCast
For C++ only: determines the most derived type of current object, casts the data explorer to that, and displays it. This command needs a window number.
ViewField
Changes the data explorer to look at a field. This command needs a y value and a window number.
NewViewField
Opens a new data explorer to look at a field. This command needs a y value and a window number.
FormatMenu
Opens the format menu. This command needs a window number and a press/release field.
ToggleFreeze
Toggles the data explorer between being frozen or not. This command needs a window number.
Duplicate
Opens another copy of this data explorer. This command needs a window number.
DuplicateFreeze
Opens another copy and freezes the current data explorer. This command needs a window number.
CloseView
Pops to a previous data explorer if it exists, or removes the data explorer. This command needs a window number.
KillView
Removes the data explorer. This command needs a window number.
PopView
Pops to a previous data explorer. This command needs a window number.
Help
Pops up a small help window describing the behavior of the data explorer.

Related topic:


Previous

Next



Copyright © 1999, Green Hills Software. All rights reserved.