Button Bar - Revision history

Ekern at 17:08, 7 April 2023

2023-04-07T17:08:12Z

← Older revision		Revision as of 17:08, 7 April 2023
Line 88:		Line 88:

	<span class="f_Para">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: </span>		<span class="f_Para">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: </span>

	[[File:butbarpos4a_zoom60.gif\|620x92px\|butbarPos4a]]		[[File:butbarpos4a_zoom60.gif\|620x92px\|butbarPos4a]]

Ekern at 17:07, 7 April 2023

2023-04-07T17:07:55Z

← Older revision		Revision as of 17:07, 7 April 2023
Line 1:		Line 1:
	__TOC__		__TOC__
	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.		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.

	[[File:butbar_zoom70.gif\|541x72px\|butbar]]		[[File:butbar_zoom70.gif\|541x72px\|butbar]]

	<span class="f_Para">These same operations can also be invoked by Client [[Menu bar (Debugger)\|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">These same operations can also be invoked by Client [[Menu bar (Debugger)\|menu]] options and by keyboard shortcut. The operations are implemented by Client [[copy command (debugger)\|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>

Ekern at 17:06, 7 April 2023

2023-04-07T17:06:48Z

Ekern at 19:17, 3 April 2023

2023-04-03T19:17:47Z

← Older revision		Revision as of 19:17, 3 April 2023
Line 22:		Line 22:

	* Program execution		* Program execution
	<span class="f_Para">The </span><span class="term">Step</span><span class="f_Para">, </span><span class="term">Step Over,</span><span class="f_Para"> and </span><span class="term">Run</span><span class="f_Para"> buttons advance the </span><span class="term">Source Code</span><span class="f_Para"> page (or </span><span class="term">Daemon</span><span class="f_Para"> page) processing position by executing one or more "executable" User Language statements. For more details, see </span><span class="f_ListContinue">[[Step, Step Over, and Run\|Step, Step Over, Run.]] </span>		: <span class="f_Para">The </span><span class="term">Step</span><span class="f_Para">, </span><span class="term">Step Over,</span><span class="f_Para"> and </span><span class="term">Run</span><span class="f_Para"> buttons advance the </span><span class="term">Source Code</span><span class="f_Para"> page (or </span><span class="term">Daemon</span><span class="f_Para"> page) processing position by executing one or more "executable" User Language statements. For more details, see </span><span class="f_ListContinue">[[Step, Step Over, and Run\|Step, Step Over, Run.]] </span>
	: By [[Default settings of buttons and hot keys\|default]], the F5 key is equivalent to the </span><span class="term">Run</span><span class="f_ListContinue"> button; F4 is equivalent to </span><span class="term">Step</span><span class="f_ListContinue"> (as is F11); and F10 is equivalent to </span><span class="term">Step Over</span><span class="f_ListContinue">. </span>		: By [[Default settings of buttons and hot keys\|default]], the F5 key is equivalent to the </span><span class="term">Run</span><span class="f_ListContinue"> button; F4 is equivalent to </span><span class="term">Step</span><span class="f_ListContinue"> (as is F11); and F10 is equivalent to </span><span class="term">Step Over</span><span class="f_ListContinue">. </span>

Ekern at 19:17, 3 April 2023

2023-04-03T19:17:31Z

Show changes

Ekern at 22:38, 21 November 2022

2022-11-21T22:38:09Z

Ekern at 17:54, 1 November 2022

2022-11-01T17:54:43Z

← Older revision		Revision as of 17:54, 1 November 2022
Line 33:		Line 33:
	*Page clearing		*Page clearing

	<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 [[The lower windows\|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 command\|clearBreaks]]</span><span class="f_ListContinue">, and </span><var>[[clearWatch command\|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 command\|.]]</span><span class="f_ListContinue"> </span>

	=== Positioning the button bar within the Client window ===		=== Positioning the button bar within the Client window ===

Ekern at 02:28, 23 September 2022

2022-09-23T02:28:41Z

Ekern at 02:19, 23 September 2022

2022-09-23T02:19:30Z

← Older revision		Revision as of 02:19, 23 September 2022
Line 8:		Line 8:
	<span class="f_Para">The subsections below describe how: </span>		<span class="f_Para">The subsections below describe how: </span>

	*The buttons may be divided into function categories. ~~</span>~~		*The buttons may be divided into function categories.
			*The [[Button Bar#Positioning the button bar within the Client window\|position of the main button bar]] may be changed.
	*The [[~~review_common_buttons.html~~#~~position_main_button_bar~~\|position of the main button bar]] may be changed.		*You can [[Button Bar#Launching an external button bar\|extract the button bar]] to a window that is external to the Client.
	*You can [[~~review_common_buttons.html~~#~~launch_ext_but_bar~~\|extract the button bar]] to a window that is external to the Client.		*You can [[Button Bar#Launching a second button bar\|create an extra button bar]] if you want more than the 15 buttons that the main button bar can accommodate.
	*You can [[~~review_common_buttons.html~~#~~launch_second_bar~~\|create an extra button bar]] if you want more than the 15 buttons that the main button bar can accommodate.

	=== Types of buttons ===		=== Types of buttons ===
Line 26:		Line 25:
	*Program execution		*Program execution
	<span class="f_Para">The </span><span class="term">Step</span><span class="f_Para">, </span><span class="term">Step Over,</span><span class="f_Para"> and </span><span class="term">Run</span><span class="f_Para"> buttons advance the </span><span class="term">Source Code</span><span class="f_Para"> page (or </span><span class="term">Daemon</span><span class="f_Para"> page) processing position by executing one or more "executable" User Language statements. For more details, see </span><span class="f_ListContinue">[[step_next_over_run.html\|Step, Step Over, Run.]] </span>		<span class="f_Para">The </span><span class="term">Step</span><span class="f_Para">, </span><span class="term">Step Over,</span><span class="f_Para"> and </span><span class="term">Run</span><span class="f_Para"> buttons advance the </span><span class="term">Source Code</span><span class="f_Para"> page (or </span><span class="term">Daemon</span><span class="f_Para"> page) processing position by executing one or more "executable" User Language statements. For more details, see </span><span class="f_ListContinue">[[step_next_over_run.html\|Step, Step Over, Run.]] </span>
	: By [[~~default_buttons_keys.html~~\|default]], the F5 key is equivalent to the </span><span class="term">Run</span><span class="f_ListContinue"> button; F4 is equivalent to </span><span class="term">Step</span><span class="f_ListContinue"> (as is F11); and F10 is equivalent to </span><span class="term">Step Over</span><span class="f_ListContinue">. </span>		: By [[Default settings of buttons and hot keys\|default]], the F5 key is equivalent to the </span><span class="term">Run</span><span class="f_ListContinue"> button; F4 is equivalent to </span><span class="term">Step</span><span class="f_ListContinue"> (as is F11); and F10 is equivalent to </span><span class="term">Step Over</span><span class="f_ListContinue">. </span>

	: The <span class="term">Cancel</span><span class="f_ListContinue"> button [[end_execution_early.html\|stops the execution]] of the current program in the </span><span class="term">Source Code</span><span class="f_ListContinue"> page. You can cancel the request at any time. </span>		: The <span class="term">Cancel</span><span class="f_ListContinue"> button [[end_execution_early.html\|stops the execution]] of the current program in the </span><span class="term">Source Code</span><span class="f_ListContinue"> page. You can cancel the request at any time. </span>

	: The <span class="f_Para">mappable Client commands</span><span class="f_ListContinue"> that perform these execution actions are </span><var>[[~~step_cmd.html~~\|step]]</span><span class="f_ListContinue">, </span><var>[[~~stepover_cmd.html~~\|stepOver]]</span><span class="f_ListContinue">, </span><var>[[~~run_cmd.html~~\|run]]</span><span class="f_ListContinue">, and </span><var>[[~~cancel_cmd.html~~\|cancel.]]</span><span class="f_ListContinue"> </span>		: The <span class="f_Para">mappable Client commands</span><span class="f_ListContinue"> that perform these execution actions are </span><var>[[step command\|step]]</span><span class="f_ListContinue">, </span><var>[[stepOver command\|stepOver]]</span><span class="f_ListContinue">, </span><var>[[run command\|run]]</span><span class="f_ListContinue">, and </span><var>[[cancel command\|cancel.]]</span><span class="f_ListContinue"> </span>

	*Page clearing ~~<span id="page_clear_buttons" class="hmanchor"></span></span>~~		*Page clearing

	<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>
Line 38:		Line 37:
	<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_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 id~~=~~"position_main_button_bar" class~~=~~"hmanchor"></span><span class~~=~~"f_Subhead">~~Positioning the button bar within the Client ~~window </span>~~		=== Positioning the button bar within the Client window ===

	<span class="f_Para">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: </span>		<span class="f_Para">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: </span>

Line 61:		Line 59:
	: To move the button bar to this position, select the <span class="term">Bottom</span><span class="f_ListNum2"> </span><span class="f_ListContinue">option in the </span><span class="term">Main Button Bar</span><span class="f_ListNum2"> </span><span class="f_ListContinue">area of the </span><span class="term">Preferences</span><span class="f_ListContinue"> dialog box</span>.		: To move the button bar to this position, select the <span class="term">Bottom</span><span class="f_ListNum2"> </span><span class="f_ListContinue">option in the </span><span class="term">Main Button Bar</span><span class="f_ListNum2"> </span><span class="f_ListContinue">area of the </span><span class="term">Preferences</span><span class="f_ListContinue"> dialog box</span>.

	: The <span class="f_Para">[[~~intro_configurable_components.html#ui_commands~~\|mappable Client command]]</span><span class="f_ListContinue"> that positions the button bar is </span><span class="f_Para">[[~~mainbuttonbar_cmd.html~~\|mainButtonBar.]] </span>		: The <span class="f_Para">[[Introducing the configurable components\|mappable Client command]]</span><span class="f_ListContinue"> that positions the button bar is </span><span class="f_Para">[[mainButtonBar command\|mainButtonBar.]] </span>

	=== Launching an external button bar ===		=== Launching an external button bar ===
Line 68:		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>
	*~~I</span><span class="f_ListNum2">nvoking~~ a button, key, or macro [[~~reconfiguring_gui_buttons.html~~\|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_cmd.html\|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>

Ekern: Created page with "TOC 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..."

2022-09-22T16:08:56Z

Created page with "__TOC__ 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..."

New page

__TOC__
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: 

 [[File:butbar_zoom70.gif|541x72px|butbar]]

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. 

The subsections below describe how: 

*The buttons may be divided into function categories. 

*The [[review_common_buttons.html#position_main_button_bar|position of the main button bar]] may be changed.
*You can [[review_common_buttons.html#launch_ext_but_bar|extract the button bar]] to a window that is external to the Client.
*You can [[review_common_buttons.html#launch_second_bar|create an extra button bar]] if you want more than the 15 buttons that the main button bar can accommodate.

=== 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 [[tour_tabbed_pages.html#audit_trail_tab|Audit Trail]], [[tour_tabbed_pages.html#source_code_tab|Source Code]] (or [[debug_req_spawn_daem.html|Daemon]]), or [[tour_tabbed_pages.html#web_buffer_tab|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 [[intro_configurable_components.html#ui_commands|mappable Client commands]] that perform the same actions are <var>[[top_cmd.html|top]] and <var>[[bottom_cmd.html|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_next_over_run.html|Step, Step Over, Run.]] 
: By [[default_buttons_keys.html|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 [[end_execution_early.html|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 <var>[[step_cmd.html|step]], <var>[[stepover_cmd.html|stepOver]], <var>[[run_cmd.html|run]], and <var>[[cancel_cmd.html|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 [[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]]. 

The mappable Client commands that perform these actions are <var>[[clearAudit command|clearAudit]], <var>[[clearbreaks_cmd.html|clearBreaks]], and <var>[[clearwatch_cmd.html|clearWatch]][[cancel_cmd.html|.]] 

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): 

[[File:butbarpos2a_zoom60.gif|620x233px|butbarPos2a]] 

: To move the button bar to this position: 

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

 [[File:preferences20frag3a_zoom50.gif|232x213px|preferences20frag3a]] 

The button bar immediately relocates.

*At the very bottom of the Client window: 

[[File:butbarpos3a_zoom60.gif|619x232px|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 [[intro_configurable_components.html#ui_commands|mappable Client command]] that positions the button bar is [[mainbuttonbar_cmd.html|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:

*Selecting the Show Main Button Bar in External Window option of the Window menu
*Invoking a button, key, or macro [[reconfiguring_gui_buttons.html|mapped]] to the <var>[[openexternalbuttonwindow_cmd.html|openExternalButtonWindow]] or the <var>[[buttonBar command|buttonBar]] command 

The resulting external Button Bar 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 (<var>[[closeExternalButtonWindow 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. 

 [[File:butbar3_zoom60.gif|530x66px|butbar3]] 

The <var>buttonBar</var> 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 <var>buttonBar</var> 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 [[Introducing the configurable components|mappable]] in the <var>ui.xml</var> file or via the <var>[[mapButton command|mapButton]]</var> 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 [[Reconfiguring GUI buttons and hot keys|mapped]] to the <var>[[extraButtonBar command|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 [[Opening an external window|external windows.]] 

[[File:exbuttonbar2_zoom60.gif|530x76px|exButtonBar2]]

As stated above, you add buttons to the extra button bar by mapping them in the <var>ui.xml</var> 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 [[Introducing the configurable components#Named buttons and separators|named]] <var>extraButton0</var> through <var>extraButton14.</var> 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: 

[[File:butbarpos4a_zoom60.gif|620x92px|butbarPos4a]] 

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

*Select the Extra Buttons checkbox of the [[file_menu_opts.html#preferences|Preferences]] dialog box 
*Invoke a button, key, or macro mapped to an <var>[[extraButtonBar command|extraButtonBar]]</var> command that specifies the position parameter <var>main</var>. 

If the main and second button bars are open in separate external windows, selecting the Extra Buttons checkbox or invoking an <var>extraButtonBar main</var> 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. 

[[Category:Debugger Home]]

← Older revision		Revision as of 17:06, 7 April 2023
Line 1:		Line 1:
	__TOC__		__TOC__
	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.		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.
	~~<!--~~ [[File:butbar_zoom70.gif\|541x72px\|butbar]] ~~-->~~		[[File:butbar_zoom70.gif\|541x72px\|butbar]]

	<span class="f_Para">These same operations can also be invoked by Client [[Menu bar (Debugger)\|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">These same operations can also be invoked by Client [[Menu bar (Debugger)\|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>
Line 39:		Line 39:

	* Immediately below the main tabs (but above the search, tracing, and value displaying controls): </span>		* Immediately below the main tabs (but above the search, tracing, and value displaying controls): </span>
	~~<!--~~ [[File:butbarpos2a_zoom60.gif\|620x233px\|butbarPos2a]]~~<span class="f_ListContinue"> </span> -->~~		[[File:butbarpos2a_zoom60.gif\|620x233px\|butbarPos2a]]
	: To move the button bar to this position: ~~</span>~~		: To move the button bar to this position:

	# 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.		# 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:

	~~<!-- <span class="f_ListContinue2"> </span>~~[[File:preferences20frag3a_zoom50.gif\|232x213px\|preferences20frag3a]]~~<span class="f_ListContinue2"> </span> -->~~		[[File:preferences20frag3a_zoom50.gif\|232x213px\|preferences20frag3a]]

	<span class="f_Para">The button bar immediately relocates.</span>		<span class="f_Para">The button bar immediately relocates.</span>

	* At the very bottom of the Client window: </span>		* At the very bottom of the Client window: </span>
	~~<!--~~ [[File:butbarpos3a_zoom60.gif\|619x232px\|butbarPos3a]]~~<span class="f_ListContinue"> </span> -->~~		[[File:butbarpos3a_zoom60.gif\|619x232px\|butbarPos3a]]
	: To move the button bar to this position, select the <span class="term">Bottom</span><span class="f_ListNum2"> </span><span class="f_ListContinue">option in the </span><span class="term">Main Button Bar</span><span class="f_ListNum2"> </span><span class="f_ListContinue">area of the </span><span class="term">Preferences</span><span class="f_ListContinue"> dialog box</span>.		: To move the button bar to this position, select the <span class="term">Bottom</span><span class="f_ListNum2"> </span><span class="f_ListContinue">option in the </span><span class="term">Main Button Bar</span><span class="f_ListNum2"> </span><span class="f_ListContinue">area of the </span><span class="term">Preferences</span><span class="f_ListContinue"> dialog box</span>.

Line 63:		Line 63:

	<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>
	~~<!-- <span class="f_Para">~~ [[File:butbar3_zoom60.gif\|530x66px\|butbar3]] ~~</span> -->~~		[[File:butbar3_zoom60.gif\|530x66px\|butbar3]]

	<span class="f_ListBul2">The </span><var>buttonBar</var><span class="f_ListNum2"> command </span><span class="f_ListBul2">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 </span><span class="term">Button Bar</span><span class="f_ListBul2"> window </span><span class="term">Dock</span><span class="f_ListBul2"> menu has </span><span class="term">Top</span><span class="f_ListBul2">, </span><span class="term">Bottom</span><span class="f_ListBul2">, and </span><span class="term">Float</span><span class="f_ListBul2"> options that perform the same functions as the corresponding </span><var>buttonBar</var><span class="f_ListNum2"> command arguments. </span>		<span class="f_ListBul2">The </span><var>buttonBar</var><span class="f_ListNum2"> command </span><span class="f_ListBul2">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 </span><span class="term">Button Bar</span><span class="f_ListBul2"> window </span><span class="term">Dock</span><span class="f_ListBul2"> menu has </span><span class="term">Top</span><span class="f_ListBul2">, </span><span class="term">Bottom</span><span class="f_ListBul2">, and </span><span class="term">Float</span><span class="f_ListBul2"> options that perform the same functions as the corresponding </span><var>buttonBar</var><span class="f_ListNum2"> command arguments. </span>
Line 75:		Line 75:

	<span class="f_ListBul2">The resulting external </span><span class="term">Extra Buttons</span><span class="f_ListBul2"> window is just like the external main </span><span class="term">Button Bar</span><span class="f_ListBul2"> window (described above), and it shares the characteristics of the other Client [[Opening an external window\|external windows.]]</span><span class="f_Para"> </span>		<span class="f_ListBul2">The resulting external </span><span class="term">Extra Buttons</span><span class="f_ListBul2"> window is just like the external main </span><span class="term">Button Bar</span><span class="f_ListBul2"> window (described above), and it shares the characteristics of the other Client [[Opening an external window\|external windows.]]</span><span class="f_Para"> </span>
	~~<!--~~ [[File:exbuttonbar2_zoom60.gif\|530x76px\|exButtonBar2]] ~~-->~~		[[File:exbuttonbar2_zoom60.gif\|530x76px\|exButtonBar2]]

	<span class="f_Para">As stated above, you add buttons to the extra button bar by mapping them in the </span><var>ui.xml</var><span class="f_Para"> 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 [[Introducing the configurable components#Named buttons and separators\|named]] </span><var>extraButton0</var><span class="f_Para"> through </span><var>extraButton14.</var><span class="f_Para"> For example, the buttons in the extra button bar shown above result from the following commands: </span>		<span class="f_Para">As stated above, you add buttons to the extra button bar by mapping them in the </span><var>ui.xml</var><span class="f_Para"> 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 [[Introducing the configurable components#Named buttons and separators\|named]] </span><var>extraButton0</var><span class="f_Para"> through </span><var>extraButton14.</var><span class="f_Para"> For example, the buttons in the extra button bar shown above result from the following commands: </span>
Line 87:		Line 87:

	<span class="f_Para">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: </span>		<span class="f_Para">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: </span>
	~~<!--~~ [[File:butbarpos4a_zoom60.gif\|620x92px\|butbarPos4a]]~~<span class="f_Para"> </span> -->~~		[[File:butbarpos4a_zoom60.gif\|620x92px\|butbarPos4a]]

	<span class="f_Para">To merge extra buttons with those in the main button bar (instead of opening a second button bar), define the mapping commands in </span><var>ui.xml</var><span class="f_Para"> as above, then do either of the following: </span>		<span class="f_Para">To merge extra buttons with those in the main button bar (instead of opening a second button bar), define the mapping commands in </span><var>ui.xml</var><span class="f_Para"> as above, then do either of the following: </span>

← Older revision		Revision as of 22:38, 21 November 2022
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 and hot keys\|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 (Debugger)\|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 19:		Line 19:
	*Page navigation </span>		*Page navigation </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="term">Top </span><span class="f_ListContinue">and </span><span class="term">Bottom</span><span class="f_ListContinue"> buttons operate on the currently active [[The tabbed pages#Audit Trail tab\|Audit Trail]], </span><span class="f_SimpleList">[[The tabbed pages#Source Code tab\|Source Code]] </span><span class="f_ListContinue">(or [[Debugging requests that spawn daemons\|Daemon]]), or [[The tabbed pages#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">[[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>		<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
	<span class="f_Para">The </span><span class="term">Step</span><span class="f_Para">, </span><span class="term">Step Over,</span><span class="f_Para"> and </span><span class="term">Run</span><span class="f_Para"> buttons advance the </span><span class="term">Source Code</span><span class="f_Para"> page (or </span><span class="term">Daemon</span><span class="f_Para"> page) processing position by executing one or more "executable" User Language statements. For more details, see </span><span class="f_ListContinue">[[~~step_next_over_run.html~~\|Step, Step Over, Run.]] </span>		<span class="f_Para">The </span><span class="term">Step</span><span class="f_Para">, </span><span class="term">Step Over,</span><span class="f_Para"> and </span><span class="term">Run</span><span class="f_Para"> buttons advance the </span><span class="term">Source Code</span><span class="f_Para"> page (or </span><span class="term">Daemon</span><span class="f_Para"> page) processing position by executing one or more "executable" User Language statements. For more details, see </span><span class="f_ListContinue">[[Step, Step Over, and Run\|Step, Step Over, Run.]] </span>
	: By [[Default settings of buttons and hot keys\|default]], the F5 key is equivalent to the </span><span class="term">Run</span><span class="f_ListContinue"> button; F4 is equivalent to </span><span class="term">Step</span><span class="f_ListContinue"> (as is F11); and F10 is equivalent to </span><span class="term">Step Over</span><span class="f_ListContinue">. </span>		: By [[Default settings of buttons and hot keys\|default]], the F5 key is equivalent to the </span><span class="term">Run</span><span class="f_ListContinue"> button; F4 is equivalent to </span><span class="term">Step</span><span class="f_ListContinue"> (as is F11); and F10 is equivalent to </span><span class="term">Step Over</span><span class="f_ListContinue">. </span>

	: The <span class="term">Cancel</span><span class="f_ListContinue"> button [[~~end_execution_early.html~~\|stops the execution]] of the current program in the </span><span class="term">Source Code</span><span class="f_ListContinue"> page. You can cancel the request at any time. </span>		: The <span class="term">Cancel</span><span class="f_ListContinue"> button [[Cancelling execution\|stops the execution]] of the current program in the </span><span class="term">Source Code</span><span class="f_ListContinue"> page. You can cancel the request at any time. </span>

	: The <span class="f_Para">mappable Client commands</span><span class="f_ListContinue"> that perform these execution actions are </span><var>[[step command\|step]]</span><span class="f_ListContinue">, </span><var>[[stepOver command\|stepOver]]</span><span class="f_ListContinue">, </span><var>[[run command\|run]]</span><span class="f_ListContinue">, and </span><var>[[cancel command\|cancel.]]</span><span class="f_ListContinue"> </span>		: The <span class="f_Para">mappable Client commands</span><span class="f_ListContinue"> that perform these execution actions are </span><var>[[step command\|step]]</span><span class="f_ListContinue">, </span><var>[[stepOver command\|stepOver]]</span><span class="f_ListContinue">, </span><var>[[run command\|run]]</span><span class="f_ListContinue">, and </span><var>[[cancel command\|cancel.]]</span><span class="f_ListContinue"> </span>
Line 33:		Line 33:
	*Page clearing		*Page clearing

	<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 [[The lower windows\|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\|breakpoints]] defined in the program being debugged, and the Client's [[The lower windows\|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 command\|clearBreaks]]</span><span class="f_ListContinue">, and </span><var>[[clearWatch command\|clearWatch]][[cancel command\|.]]</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 command\|.]]</span><span class="f_ListContinue"> </span>
Line 100:		Line 100:
	<span class="f_Para">To merge extra buttons with those in the main button bar (instead of opening a second button bar), define the mapping commands in </span><var>ui.xml</var><span class="f_Para"> as above, then do either of the following: </span>		<span class="f_Para">To merge extra buttons with those in the main button bar (instead of opening a second button bar), define the mapping commands in </span><var>ui.xml</var><span class="f_Para"> as above, then do either of the following: </span>

	*Select the</span><span class="f_ListBul1"> </span><span class="term">Extra Buttons</span><span class="f_Para"> checkbox</span><span class="f_ListBul1"> of the </span><span class="term">[[~~file_menu_opts.html~~#~~preferences~~\|Preferences]]</span><span class="f_ListBul1"> dialog box </span>		*Select the</span><span class="f_ListBul1"> </span><span class="term">Extra Buttons</span><span class="f_Para"> checkbox</span><span class="f_ListBul1"> of the </span><span class="term">[[File menu options#Preferences\|Preferences]]</span><span class="f_ListBul1"> dialog box </span>
	*Invoke a button, key, or macro mapped to an </span><var>[[extraButtonBar command\|extraButtonBar]]</var><span class="f_ListNum2"> command that specifies the position parameter </span><var>main</var><span class="f_ListNum2">. </span>		*Invoke a button, key, or macro mapped to an </span><var>[[extraButtonBar command\|extraButtonBar]]</var><span class="f_ListNum2"> command that specifies the position parameter </span><var>main</var><span class="f_ListNum2">. </span>

← Older revision		Revision as of 02:28, 23 September 2022
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>

Button Bar - Revision history

Ekern at 17:08, 7 April 2023

Ekern at 17:07, 7 April 2023

Ekern at 17:06, 7 April 2023

Ekern at 19:17, 3 April 2023

Ekern at 19:17, 3 April 2023

Ekern at 22:38, 21 November 2022

Ekern at 17:54, 1 November 2022

Ekern at 02:28, 23 September 2022

Ekern at 02:19, 23 September 2022

Ekern: Created page with "__TOC__ 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..."

Ekern: Created page with "TOC 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..."