EnableButton command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Created page with "__TOC__ {| |width="50%"| '''Action:''' |width="50%"| <span class="f_Para">Enables the (currently disabled) button bar button that you specify....")
 
No edit summary
Line 4: Line 4:
|width="50%"| '''Action:'''
|width="50%"| '''Action:'''
|width="50%"|
|width="50%"|
<span class="f_Para">Enables the (currently disabled) [[review_common_buttons.html|button bar button]] that you specify. A disabled button performs no action and has gray text.  </span>
<span class="f_Para">Enables the (currently disabled) [[Button Bar|button bar button]] that you specify. A disabled button performs no action and has gray text.  </span>


<span class="f_Para">The </span><span class="f_CodeExample">enableButton</span><span class="f_Para"> command affects only buttons that are disabled because they were specified in a previous </span><span class="f_Monospace">[[disablebutton_cmd.html|disableButton]]</span><span class="f_CodeExample"> </span><span class="f_Para">command. If a button is disabled because its action is not appropriate in the current debugging context, </span><span class="f_CodeExample">enableButton</span><span class="f_Para"> does </span><span class="f_EmphBold">not</span><span class="f_Para"> enable the button. For example, after you cancel a request, the </span><span class="f_GUIlabel">Cancel</span><span class="f_Para"> and </span><span class="f_GUIlabel">Clear Breaks</span><span class="f_Para"> buttons are disabled, and an </span><span class="f_CodeExample">enableButton</span><span class="f_Para"> command for one of these buttons has no effect: the button remains disabled and no return message is displayed. </span>
<span class="f_Para">The </span><span class="f_CodeExample">enableButton</span><span class="f_Para"> command affects only buttons that are disabled because they were specified in a previous </span><span class="f_Monospace">[[disableButton command|disableButton]]</span><span class="f_CodeExample"> </span><span class="f_Para">command. If a button is disabled because its action is not appropriate in the current debugging context, </span><span class="f_CodeExample">enableButton</span><span class="f_Para"> does </span><span class="f_EmphBold">not</span><span class="f_Para"> enable the button. For example, after you cancel a request, the </span><span class="f_GUIlabel">Cancel</span><span class="f_Para"> and </span><span class="f_GUIlabel">Clear Breaks</span><span class="f_Para"> buttons are disabled, and an </span><span class="f_CodeExample">enableButton</span><span class="f_Para"> command for one of these buttons has no effect: the button remains disabled and no return message is displayed. </span>


'''Syntax:'''
'''Syntax:'''
Line 12: Line 12:
<p class="syntax">enableButton ''buttonName'' </p>
<p class="syntax">enableButton ''buttonName'' </p>


<span class="f_Para">where </span><span class="f_EmphItal">buttonName</span><span class="f_Para"> is </span><span class="f_Monospace">button0,</span><span class="f_ListBul1"> </span><span class="f_Monospace">button1,</span><span class="f_Para"> etc; </span><span class="f_ListBul1">that is, the name of a currently </span><span class="f_Para">[[intro_configurable_components.html#named_buttons|mapped]] </span><span class="f_ListBul1">button. </span><span class="f_Para"> </span>
<span class="f_Para">where </span><span class="term">buttonName</span><span class="f_Para"> is </span><span class="f_Monospace">button0,</span><span class="f_ListBul1"> </span><span class="f_Monospace">button1,</span><span class="f_Para"> etc; </span><span class="f_ListBul1">that is, the name of a currently </span><span class="f_Para">[[Introducing the configurable components#Named buttons and separators|mapped]] </span><span class="f_ListBul1">button. </span><span class="f_Para"> </span>


<span class="f_Para">If the command executes successfully, you receive an </span><span class="f_Monospace">Enabled button: </span><span class="f_MonoItal">buttonName</span><span class="f_Para"> message, and the button's label changes from gray text to black. </span>
<span class="f_Para">If the command executes successfully, you receive an </span><span class="f_Monospace">Enabled button: </span><span class="f_MonoItal">buttonName</span><span class="f_Para"> message, and the button's label changes from gray text to black. </span>

Revision as of 04:31, 29 November 2022

Action:

Enables the (currently disabled) button bar button that you specify. A disabled button performs no action and has gray text.  

The enableButton command affects only buttons that are disabled because they were specified in a previous disableButton command. If a button is disabled because its action is not appropriate in the current debugging context, enableButton does not enable the button. For example, after you cancel a request, the Cancel and Clear Breaks buttons are disabled, and an enableButton command for one of these buttons has no effect: the button remains disabled and no return message is displayed.

Syntax:

enableButton buttonName 

where buttonName is button0, button1, etc; that is, the name of a currently mapped button.

If the command executes successfully, you receive an Enabled button: buttonName message, and the button's label changes from gray text to black.

Client menu: --
Introduced: Build 62