Button Bar: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 4: Line 4:
<span class="f_Para"> </span>[[File:butbar_zoom70.gif|541x72px|butbar]]
<span class="f_Para"> </span>[[File:butbar_zoom70.gif|541x72px|butbar]]


<span class="f_Para">These same operations can also be invoked by Client [[menu_bar.html|menu]] options and by keyboard shortcut. The operations are implemented by Client [[copy command|commands]], of which there are many more than there are buttons. You can change the default [[reconfiguring_gui_buttons.html|mapping of buttons and hot keys]] to commands to suit your preference. </span>
<span class="f_Para">These same operations can also be invoked by Client [[menu_bar.html|menu]] options and by keyboard shortcut. The operations are implemented by Client [[copy command|commands]], of which there are many more than there are buttons. You can change the default [[Reconfiguring GUI buttons and hot keys|mapping of buttons and hot keys]] to commands to suit your preference. </span>


<span class="f_Para">The subsections below describe how: </span>
<span class="f_Para">The subsections below describe how: </span>
Line 21: Line 21:
<span class="f_ListContinue">The </span><span class="term">Top </span><span class="f_ListContinue">and </span><span class="term">Bottom</span><span class="f_ListContinue"> buttons operate on the currently active [[tour_tabbed_pages.html#audit_trail_tab|Audit Trail]], </span><span class="f_SimpleList">[[tour_tabbed_pages.html#source_code_tab|Source Code]] </span><span class="f_ListContinue">(or [[debug_req_spawn_daem.html|Daemon]]), or [[tour_tabbed_pages.html#web_buffer_tab|Web Buffer]] tab. </span><span class="term">Top</span><span class="f_ListContinue"> brings to the top of the page the first line of the current page. </span><span class="term">Bottom</span><span class="f_ListContinue"> highlights the last line of the current page. </span>
<span class="f_ListContinue">The </span><span class="term">Top </span><span class="f_ListContinue">and </span><span class="term">Bottom</span><span class="f_ListContinue"> buttons operate on the currently active [[tour_tabbed_pages.html#audit_trail_tab|Audit Trail]], </span><span class="f_SimpleList">[[tour_tabbed_pages.html#source_code_tab|Source Code]] </span><span class="f_ListContinue">(or [[debug_req_spawn_daem.html|Daemon]]), or [[tour_tabbed_pages.html#web_buffer_tab|Web Buffer]] tab. </span><span class="term">Top</span><span class="f_ListContinue"> brings to the top of the page the first line of the current page. </span><span class="term">Bottom</span><span class="f_ListContinue"> highlights the last line of the current page. </span>


<span class="f_ListContinue">The </span><span class="f_Para">[[intro_configurable_components.html#ui_commands|mappable Client commands]]</span><span class="f_ListContinue"> that perform the same actions are </span><var>[[top_cmd.html|top]]</span><span class="f_ListContinue"> and </span><var>[[bottom_cmd.html|bottom.]]</span><span class="f_ListContinue"> </span>
<span class="f_ListContinue">The </span><span class="f_Para">[[Introducing the configurable components|mappable Client commands]]</span><span class="f_ListContinue"> that perform the same actions are </span><var>[[top command|top]]</span><span class="f_ListContinue"> and </span><var>[[bottom command|bottom.]]</span><span class="f_ListContinue"> </span>


*Program execution
*Program execution
Line 35: Line 35:
<span class="f_ListContinue">The </span><span class="term">Clear Audit</span><span class="f_ListContinue">, </span><span class="term">Clear Breaks</span><span class="f_ListContinue">, and </span><span class="term">Clear Watch</span><span class="f_ListContinue"> buttons remove entirely the contents of the Client's </span><span class="term">Audit Trail</span><span class="f_ListContinue"> tabbed page, the [[using_breakpoints.html|breakpoints]] defined in the program being debugged, and the Client's [[a_look_at_the_lower_windows.html#watch_window2|Watch Window]]. </span>
<span class="f_ListContinue">The </span><span class="term">Clear Audit</span><span class="f_ListContinue">, </span><span class="term">Clear Breaks</span><span class="f_ListContinue">, and </span><span class="term">Clear Watch</span><span class="f_ListContinue"> buttons remove entirely the contents of the Client's </span><span class="term">Audit Trail</span><span class="f_ListContinue"> tabbed page, the [[using_breakpoints.html|breakpoints]] defined in the program being debugged, and the Client's [[a_look_at_the_lower_windows.html#watch_window2|Watch Window]]. </span>


<span class="f_ListContinue">The </span><span class="f_Para">mappable Client commands</span><span class="f_ListContinue"> that perform these actions are </span><var>[[clearAudit command|clearAudit]]</span><span class="f_ListContinue">, </span><var>[[clearbreaks_cmd.html|clearBreaks]]</span><span class="f_ListContinue">, and </span><var>[[clearwatch_cmd.html|clearWatch]][[cancel_cmd.html|.]]</span><span class="f_ListContinue"> </span>
<span class="f_ListContinue">The </span><span class="f_Para">mappable Client commands</span><span class="f_ListContinue"> that perform these actions are </span><var>[[clearAudit command|clearAudit]]</span><span class="f_ListContinue">, </span><var>[[clearBreaks command|clearBreaks]]</span><span class="f_ListContinue">, and </span><var>[[clearWatch command|clearWatch]][[cancel_cmd.html|.]]</span><span class="f_ListContinue"> </span>


=== Positioning the button bar within the Client window ===
=== Positioning the button bar within the Client window ===
Line 46: Line 46:
: To move the button bar to this position: </span>
: To move the button bar to this position: </span>


# From the <span class="term">File</span><span class="f_ListNum2"> menu, select </span><span class="term">Preferences</span>, or use the CTRL-P keyboard shortcut or the <var>[[preferences_cmd.html|preferences]]</var><span class="f_ListNum2"> command.
# From the <span class="term">File</span><span class="f_ListNum2"> menu, select </span><span class="term">Preferences</span>, or use the CTRL-P keyboard shortcut or the <var>[[preferences command|preferences]]</var><span class="f_ListNum2"> command.
# In the <span class="term">Main Button Bar</span> area of the <span class="term">Preferences</span> dialog box, select the <span class="term">Center</span> option:  
# In the <span class="term">Main Button Bar</span> area of the <span class="term">Preferences</span> dialog box, select the <span class="term">Center</span> option:  


Line 66: Line 66:


*Selecting the</span><span class="f_ListBul1"> </span><span class="term">Show Main Button Bar in External Window</span><span class="f_ListBul1"> option of the </span><span class="term">Window</span><span class="f_ListBul1"> menu</span>
*Selecting the</span><span class="f_ListBul1"> </span><span class="term">Show Main Button Bar in External Window</span><span class="f_ListBul1"> option of the </span><span class="term">Window</span><span class="f_ListBul1"> menu</span>
*Invoking a button, key, or macro [[Reconfiguring GUI buttons and hot keys|mapped]] to the </span><var>[[openexternalbuttonwindow_cmd.html|openExternalButtonWindow]]</span><span class="f_ListNum2"> or the </span><var>[[buttonBar command|buttonBar]]</span><span class="f_ListNum2"> command </span>
*Invoking a button, key, or macro [[Reconfiguring GUI buttons and hot keys|mapped]] to the </span><var>[[openExternalButtonWindow command|openExternalButtonWindow]]</span><span class="f_ListNum2"> or the </span><var>[[buttonBar command|buttonBar]]</span><span class="f_ListNum2"> command </span>


<span class="f_Para">The resulting external </span><span class="term">Button Bar</span><span class="f_Para"> window shares the characteristics of the other Client [[Opening an external window|external windows.]] You can close the external window at any time by Client command (</span><var>[[closeExternalButtonWindow command|closeExternalButtonWindow]]</span><span class="f_Para">), by the </span><span class="term">Exit</span><span class="f_Para"> option of the button bar </span><span class="term">File</span><span class="f_Para"> menu, or simply by clicking the </span><span class="term">X</span><span class="f_Para"> button in the upper right corner. In addition, the opened </span><span class="term">Button Bar</span><span class="f_Para"> window has </span><span class="term">Dock</span><span class="f_Para"> menu options, as described below. </span>
<span class="f_Para">The resulting external </span><span class="term">Button Bar</span><span class="f_Para"> window shares the characteristics of the other Client [[Opening an external window|external windows.]] You can close the external window at any time by Client command (</span><var>[[closeExternalButtonWindow command|closeExternalButtonWindow]]</span><span class="f_Para">), by the </span><span class="term">Exit</span><span class="f_Para"> option of the button bar </span><span class="term">File</span><span class="f_Para"> menu, or simply by clicking the </span><span class="term">X</span><span class="f_Para"> button in the upper right corner. In addition, the opened </span><span class="term">Button Bar</span><span class="f_Para"> window has </span><span class="term">Dock</span><span class="f_Para"> menu options, as described below. </span>

Revision as of 02:28, 23 September 2022

Many of the Client's basic operations are controlled by the buttons arrayed in the button bar, which by default is displayed above the main window:

butbar

These same operations can also be invoked by Client menu options and by keyboard shortcut. The operations are implemented by Client commands, of which there are many more than there are buttons. You can change the default mapping of buttons and hot keys to commands to suit your preference.

The subsections below describe how:

Types of buttons

The Client default buttons may be divided by function as follows:

  • Page navigation  

The Top and Bottom buttons operate on the currently active Audit Trail, Source Code (or Daemon), or Web Buffer tab. Top brings to the top of the page the first line of the current page. Bottom highlights the last line of the current page.

The mappable Client commands that perform the same actions are top and bottom.

  • Program execution

The Step, Step Over, and Run buttons advance the Source Code page (or Daemon page) processing position by executing one or more "executable" User Language statements. For more details, see Step, Step Over, Run.

By default, the F5 key is equivalent to the Run button; F4 is equivalent to Step (as is F11); and F10 is equivalent to Step Over.
The Cancel button stops the execution of the current program in the Source Code page. You can cancel the request at any time.
The mappable Client commands that perform these execution actions are step, stepOver, run, and cancel.
  • Page clearing

The Clear Audit, Clear Breaks, and Clear Watch buttons remove entirely the contents of the Client's Audit Trail tabbed page, the breakpoints defined in the program being debugged, and the Client's Watch Window.

The mappable Client commands that perform these actions are clearAudit, clearBreaks, and clearWatch.

Positioning the button bar within the Client window

You can change the location of the main button bar from its default (above the main tabs) to either of these other positions in the Client window:

  • Immediately below the main tabs (but above the search, tracing, and value displaying controls):

butbarPos2a

To move the button bar to this position:
  1. From the File menu, select Preferences, or use the CTRL-P keyboard shortcut or the preferences command.
  2. In the Main Button Bar area of the Preferences dialog box, select the Center option:

preferences20frag3a

The button bar immediately relocates.

  • At the very bottom of the Client window:

butbarPos3a

To move the button bar to this position, select the Bottom option in the Main Button Bar area of the Preferences dialog box.
The mappable Client command that positions the button bar is mainButtonBar.

Launching an external button bar

For your convenience, the location of the button bar is not fixed. In addition to changing its position on the main Client window as described above, you can move the main button bar to a separate window outside the Client application window. You do so in either of the following ways:

The resulting external Button Bar window shares the characteristics of the other Client external windows. You can close the external window at any time by Client command (closeExternalButtonWindow), by the Exit option of the button bar File menu, or simply by clicking the X button in the upper right corner. In addition, the opened Button Bar window has Dock menu options, as described below.

butbar3

The buttonBar command has parameter options that let you select where on your desktop to locate the window. You can dock it, stationary, in the top or bottom left corner of the desktop, or you can simply open it, undocked, as with the launching options (menu and command) described above. Also, once opened, the Button Bar window Dock menu has Top, Bottom, and Float options that perform the same functions as the corresponding buttonBar command arguments.

Launching a second button bar

You may open an additional button bar (in the Extra Buttons external window) which can contain as many as 15 buttons. Like the buttons in the main button bar, these extra buttons are mappable in the ui.xml file or via the mapButton command. You launch such an extra button bar by either of the following:

  • Selecting the Show Extra Button Bar Window option of the Window menu  
  • Invoking a button, key, or macro mapped to the extraButtonBar command

The resulting external Extra Buttons window is just like the external main Button Bar window (described above), and it shares the characteristics of the other Client external windows.

exButtonBar2

As stated above, you add buttons to the extra button bar by mapping them in the ui.xml file to the commands you want them to execute. The mapping commands are the same as those for the buttons in the main button bar, except the buttons are named extraButton0 through extraButton14. For example, the buttons in the extra button bar shown above result from the following commands:

<mapping command="showAbout" button="extrabutton0" /> <mapping command="step" button="extrabutton1" />  <mapping command="showCommands" button="extrabutton2" />  <mapping command="help" button="extrabutton3" />  <mapping command="manual" button="extrabutton4" />  <mapping command="saveWatch" button="extrabutton5" /> 

You may add your extra buttons to the existing main button bar instead of opening an additional window. For example, the following image shows the extra buttons (defined above) added to the main button bar, which is positioned at the bottom of the Client main window:

butbarPos4a

To merge extra buttons with those in the main button bar (instead of opening a second button bar), define the mapping commands in ui.xml as above, then do either of the following:

  • Select the Extra Buttons checkbox of the Preferences dialog box  
  • Invoke a button, key, or macro mapped to an extraButtonBar command that specifies the position parameter main.

If the main and second button bars are open in separate external windows, selecting the Extra Buttons checkbox or invoking an extraButtonBar main command merges all the buttons in the primary external button bar.

Once a merged button bar exists, the extra buttons remain part of the primary button bar if it is subsequently moved to an external window from the Client, or if moved back to the Client from an external window.

To decouple a merged button bar, you can clear the Extra Buttons checkbox. Less directly, you can select Window > Show Extra Button Bar Window; this action simultaneously clears the Extra Buttons checkbox.