SetPreference command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 5: Line 5:
|width="50%"| '''Action:'''
|width="50%"| '''Action:'''
|width="50%"|
|width="50%"|
<span class="f_Para">Lets you use a [[using_debugger_macros.html|macro]] or [[intro_configurable_components.html|mapped]] button or key to control </span><span class="f_ListBul1">Client preference settings that are available via the </span><span class="f_Para">[[file_menu_opts.html#preferences|Preferences]] dialog box or the [[tour_tabbed_pages.html#proc_selection_tab|Proc Selection]] page. </span>
<span class="f_Para">Lets you use a [[Using Debugger Macros|macro]] or [[Introducing the configurable components|mapped]] button or key to control </span><span class="f_ListBul1">Client preference settings that are available via the </span><span class="f_Para">[[File menu options#Preferences|Preferences]] dialog box or the [[The tabbed pages#Proc Selection tab|Proc Selection]] page. </span>


'''Syntax:'''  
'''Syntax:'''  
<p class="syntax">setPreference ''option'' {on|off} </p>
<p class="syntax">setPreference ''option'' {on|off} </p>


<span class="f_Para">where </span><span class="f_EmphItal">option</span><span class="f_ListBul1"> is one of the following: </span>
<span class="f_Para">where </span><span class="term">option</span><span class="f_ListBul1"> is one of the following: </span>


*<span class="f_Monospace">breakAfterReadScreen</span><span class="f_ListBul1"> </span>
*<span class="f_Monospace">breakAfterReadScreen</span><span class="f_ListBul1"> </span>
**<span class="f_ListContinue">Selects or clears the</span><span class="f_Para"> </span><span class="f_GUIlabel">[[suppress_break_eval.html|Break after READ SCREEN]]</span><span class="f_Para"> </span><span class="f_ListContinue">checkbox in the Client's </span><span class="f_GUIlabel">Preferences</span><span class="f_ListContinue"> dialog box </span>
**<span class="f_ListContinue">Selects or clears the</span><span class="f_Para"> </span><span class="f_GUIlabel">[[Suppressing the break at the end of request evaluation|Break after READ SCREEN]]</span><span class="f_Para"> </span><span class="f_ListContinue">checkbox in the Client's </span><var>Preferences</var><span class="f_ListContinue"> dialog box </span>


*<span class="f_Monospace">debuggerDirectives</span><span class="f_ListBul1"> </span>
*<span class="f_Monospace">debuggerDirectives</span><span class="f_ListBul1"> </span>
**<span class="f_ListBul1">Selects or clears the </span><span class="f_GUIlabel">[[selectively_excluding_source.html#use_code-exclude_feature|Use !debugger directives]]</span><span class="f_ListContinue"> checkbox in the </span><span class="f_GUIlabel">Preferences</span><span class="f_ListContinue"> dialog box </span>
**<span class="f_ListBul1">Selects or clears the </span><span class="f_GUIlabel">[[Selectively excluding source code blocks#Using the code exclude feature in its normal mode|Use !debugger directives]]</span><span class="f_ListContinue"> checkbox in the </span><var>Preferences</var><span class="f_ListContinue"> dialog box </span>


*<span class="f_Monospace">historyToTrace</span><span class="f_ListBul1"> </span>
*<span class="f_Monospace">historyToTrace</span><span class="f_ListBul1"> </span>
**<span class="f_ListContinue">Selects or clears the</span><span class="f_Para"> </span><span class="f_GUIlabel">[[display_stmt_history.html|History To Execution Trace]]</span><span class="f_Para"> </span><span class="f_ListContinue">checkbox in the </span><span class="f_GUIlabel">Preferences</span><span class="f_ListContinue"> dialog box </span>
**<span class="f_ListContinue">Selects or clears the</span><span class="f_Para"> </span><span class="f_GUIlabel">[[Displaying a statement history|History To Execution Trace]]</span><span class="f_Para"> </span><span class="f_ListContinue">checkbox in the </span><var>Preferences</var><span class="f_ListContinue"> dialog box </span>


*<span class="f_Monospace">ignoredFileTypeList</span><span class="f_ListBul1"> </span>
*<span class="f_Monospace">ignoredFileTypeList</span><span class="f_ListBul1"> </span>
**<span class="f_ListBul1">Toggles Debugger [[customize_debugger_cfg_file.html#filetype_filter|file type filtering]] on or off: </span>
**<span class="f_ListBul1">Toggles Debugger [[Customize debuggerConfig file#Basic configuration steps|file type filtering]] on or off: </span>


<p class="syntax">setPreference ignoredFileTypeList {on|off} </p>
<p class="syntax">setPreference ignoredFileTypeList {on|off} </p>
Line 31: Line 31:


*macroAutorun
*macroAutorun
**<span class="f_ListContinue">Selects or clears the</span><span class="f_Para"> </span><span class="f_GUIlabel">[[using_macro_autorun.html|Macro Autorun]]</span><span class="f_Para"> </span><span class="f_ListContinue">checkbox in the </span><span class="f_GUIlabel">Preferences</span><span class="f_ListContinue"> dialog box </span>
**<span class="f_ListContinue">Selects or clears the</span><span class="f_Para"> </span><span class="f_GUIlabel">[[Using the Macro Autorun feature|Macro Autorun]]</span><span class="f_Para"> </span><span class="f_ListContinue">checkbox in the </span><var>Preferences</var><span class="f_ListContinue"> dialog box </span>


*pauseAtEndEval
*pauseAtEndEval
**<span class="f_ListContinue">Selects or clears the</span><span class="f_Para"> </span><span class="f_GUIlabel">[[suppress_break_eval.html|Pause at end of evaluation]]</span><span class="f_Para"> </span><span class="f_ListContinue">checkbox in the </span><span class="f_GUIlabel">Preferences</span><span class="f_ListContinue"> dialog box </span>
**<span class="f_ListContinue">Selects or clears the</span><span class="f_Para"> </span><span class="f_GUIlabel">[[Suppressing the break at the end of request evaluation|Pause at end of evaluation]]</span><span class="f_Para"> </span><span class="f_ListContinue">checkbox in the </span><span class="f_GUIlabel">Preferences</span><span class="f_ListContinue"> dialog box </span>


*<span class="f_Monospace">useProcLists</span><span class="f_ListBul1"> </span>
*<span class="f_Monospace">useProcLists</span><span class="f_ListBul1"> </span>
**<span class="f_ListContinue">Selects or clears the </span><span class="f_GUIlabel">[[selectively_excluding_source.html#use_proc_list|Use Proc Lists for exclude/include]]</span><span class="f_ListNum2"> checkbox in the </span><span class="f_ListContinue">Client's </span><span class="f_GUIlabel">Proc Selection</span><span class="f_ListContinue"> tab </span>
**<span class="f_ListContinue">Selects or clears the </span><span class="f_GUIlabel">[[Selectively excluding source code blocks#Using the code exclude feature in its normal mode|Use Proc Lists for exclude/include]]</span><span class="f_ListNum2"> checkbox in the </span><span class="f_ListContinue">Client's </span><var>Proc Selection</var><span class="f_ListContinue"> tab </span>


*<span class="f_Monospace">useRoutineLists</span><span class="f_ListBul1"> </span>
*<span class="f_Monospace">useRoutineLists</span><span class="f_ListBul1"> </span>
**<span class="f_ListContinue">Selects or clears the </span><span class="f_GUIlabel">[[selectively_excluding_source.html#use_proc_list|Use Routine Lists for exclude/include]]</span><span class="f_ListNum2"> checkbox in the </span><span class="f_ListContinue">Client's </span><span class="f_GUIlabel">Proc Selection</span><span class="f_ListContinue"> tab </span>
**<span class="f_ListContinue">Selects or clears the </span><span class="f_GUIlabel">[[Selectively excluding source code blocks#Using the code exclude feature in its normal mode|Use Routine Lists for exclude/include]]</span><span class="f_ListNum2"> checkbox in the </span><span class="f_ListContinue">Client's </span><var>Proc Selection</var><span class="f_ListContinue"> tab </span>


*<span class="f_Monospace">valueDisplayOnConsole</span><span class="f_ListBul1"> </span>
*<span class="f_Monospace">valueDisplayOnConsole</span><span class="f_ListBul1"> </span>
**<span class="f_ListContinue">Controls</span><span class="f_Para"> whether [[displaying_variable_values.html|value displays]] appear in a separate </span><span class="f_GUIlabel">Value</span><span class="f_Para"> window</span><span class="f_ListContinue"> when the </span><span class="f_GUIlabel">[[using_macro_console_cmdline.html|Console]]</span><span class="f_ListContinue"> is open (the default, </span><span class="f_Monospace">on</span><span class="f_ListContinue">, shows them in the </span><span class="f_GUIlabel">Console</span><span class="f_ListContinue"> if it is open) </span>
**<span class="f_ListContinue">Controls</span><span class="f_Para"> whether [[Displaying temporarily the value of a program data item|value displays]] appear in a separate </span><var>Value</var><span class="f_Para"> window</span><span class="f_ListContinue"> when the </span><span class="f_GUIlabel">[[Using the console and command line|Console]]</span><span class="f_ListContinue"> is open (the default, </span><span class="f_Monospace">on</span><span class="f_ListContinue">, shows them in the </span><var>Console</var><span class="f_ListContinue"> if it is open) </span>


'''Note:'''Instead of on or off, the command also takes 1 or 0.  
'''Note:'''Instead of on or off, the command also takes 1 or 0.  


<span class="f_Para">You may want to use the command to toggle a setting in a Client [[using_debugger_macros.html|macro]], for example: </span>
<span class="f_Para">You may want to use the command to toggle a setting in a Client [[Using Debugger Macros|macro]], for example: </span>


<p class="syntax"># toggle use exclude/include directives 
<p class="syntax"># toggle use exclude/include directives 

Revision as of 01:31, 10 December 2022


Action:

Lets you use a macro or mapped button or key to control Client preference settings that are available via the Preferences dialog box or the Proc Selection page.

Syntax:

setPreference option {on|off} 

where option is one of the following:

  • breakAfterReadScreen

setPreference ignoredFileTypeList {on|off} 

Where:
on honors the "ignore list" default behavior
off does no file type filtering
  • macroAutorun
    • Selects or clears the Macro Autorun checkbox in the Preferences dialog box
  • valueDisplayOnConsole
    • Controls whether value displays appear in a separate Value window when the Console is open (the default, on, shows them in the Console if it is open)

Note:Instead of on or off, the command also takes 1 or 0.

You may want to use the command to toggle a setting in a Client macro, for example:

# toggle use exclude/include directives  toggle &debuggerDirectives !Directives setPreference debuggerDirectives &debuggerDirectives 

Client menu: --
Introduced: Build 55