The Tool Bar

Some DDD commands require an argument. This argument is specified in the argument field, labeled ():. Basically, there are four ways to set arguments:

  • You can key in the argument manually.

  • You can paste the current selection into the argument field (typically using

    Illegal HTML tag removed : mouse button 2

    ). To clear old contents beforehand, click on the (): label.

  • You can select an item from the source and data windows. This will automatically copy the item to the argument field.
  • You can select a previously used argument from the drop-down menu at the right of the argument field.

Using GDB and Perl, the argument field provides a completion mechanism. You can enter the first few characters of an item an press the <TAB> key to complete it. Pressing <TAB> again shows alternative completions.

After having entered an argument, you can select one of the buttons on the right. Most of these buttons also have menus associated with them; this is indicated by a small arrow in the upper right corner. Pressing and holding mouse button 1 on such a button will pop up a menu with further operations.

PICS/ddd-toolbar.jpg

These are the buttons of the tool bar. Note that not all buttons may be inactive, depending on the current state and the capabilities of the inferior debugger.

  • Lookup

  • Look up the argument () in the source code. See Looking up Definitions, for details.

  • Find &gt;&gt;

  • Look up the next occurrence of the argument () in the current source code. See Textual Search, for details.

  • Break/Clear

  • Toggle a breakpoint (see Breakpoints) at the location ().

    • Break
    • If there is no breakpoint at (), then this button is labeled Break. Clicking on Break sets a breakpoint at the location (). See Setting Breakpoints, for details.
    • Clear
    • If there already is a breakpoint at (), then this button is labeled Clear. Clicking on Clear clears (deletes) the breakpoint at the location (). See Deleting Breakpoints, for details.

  • Watch/Unwatch* Toggle a watchpoint (see Watchpoints) on the expression ().

    • Watch
    • If () is not being watched, then this button is labeled Watch. Clicking on Watch creates a watchpoint on the expression (). See Setting Watchpoints, for details.
    • Unwatch

    • If () is being watched, then this button is labeled Unwatch. Clicking on Unwatch clears (deletes) the watchpoint on (). See Deleting Watchpoints, for details. Print Print the value of () in the debugger console. See Printing Values, for details.

    • Display* Display the value of () in the data window. See Displaying Values, for details.

    • Plot* Plot () in a plot window. See Plotting Values, for details.

    • Show/Hide* Toggle details of the selected display(s). See Showing and Hiding Details, for a discussion.

    • Rotate* Rotate the selected display(s). See Rotating Displays, for details.

    • Set* Set (change) the value of (). See Assignment, for details.

    • Undisp* Undisplay (delete) the selected display(s). See Deleting Displays, for details.

  • Customizing the Tool Bar:

Node:Customizing the Tool Bar, Up:Tool Bar

Customizing the Tool Bar

The DDD tool bar buttons can appear in a variety of styles, customized via Edit =&gt; Preferences =&gt; Startup.

  • Images
  • This lets each tool bar button show an image illustrating the action.
  • Captions
  • This shows the action name below the image.

The default is to have images as well as captions, but you can choose to have only images (saving space) or only captions.

PICS/ddd-toolbars.jpg

If you choose to have neither images nor captions, tool bar buttons are labeled like other buttons, as in DDD 2.x. Note that this implies that in the stacked window configuration, the common tool bar cannot be displayed; it is replaced by two separate tool bars, as in DDD 2.x.

If you enable Flat buttons (default), the border of tool bar buttons will appear only if the mouse pointer is over them. This latest-and-greatest GUI invention can be disabled, such that the button border is always shown.

If you enable Color buttons, tool bar images will be colored when entered. If DDD was built using M*tif 2.0 and later, you can also choose a third setting, where buttons appear in color all the time.

Here are the related resources (see Customizing):

activeButtonColorKey(class ColorKey) Resource
The XPM color key to use for the images of active buttons (entered or armed). c means color, g (default) means grey, and m means monochrome.
buttonCaptions(class ButtonCaptions) Resource
Whether the tool bar buttons should be shown using captions (on, default) or not (off). If neither captions nor images are enabled, tool bar buttons are shown using ordinary labels. See also buttonImages, below.
buttonCaptionGeometry(class ButtonCaptionGeometry) Resource
The geometry of the caption subimage within the button icons. Default is 29x7+0-0.
buttonImages(class ButtonImages) Resource
Whether the tool bar buttons should be shown using images (on, default) or not (off). If neither captions nor images are enabled, tool bar buttons are shown using ordinary labels. See also buttonCaptions, above.
buttonImageGeometry(class ButtonImageGeometry) Resource
The geometry of the image within the button icon. Default is 25x21+2+0.
buttonColorKey(class ColorKey) Resource
The XPM color key to use for the images of inactive buttons (non-entered or insensitive). c means color, g (default) means grey, and m means monochrome.
flatToolbarButtons(class FlatButtons) Resource
If on (default), all tool bar buttons with images or captions are given a flat&#039; appearance--the 3-D border only shows up when the pointer is over the icon. Ifoff`, the 3-D border is shown all the time.
flatDialogButtons(class FlatButtons) Resource
If on (default), all dialog buttons with images or captions are given a flat&#039; appearance--the 3-D border only shows up when the pointer is over the icon. Ifoff`, the 3-D border is shown all the time.

Node:Command Tool, Next:Getting Help, Previous:Tool Bar, Up:Windows

results matching ""

    No results matching ""