MapKey command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 4: Line 4:
|width="50%"| '''Action:'''
|width="50%"| '''Action:'''
|width="50%"|
|width="50%"|
<span class="f_Para">Lets you [[reconfiguring_gui_buttons.html#use_mapbutton|assign a keyboard shortcut]] without having to edit a mapping file (</span><span class="f_Monospace">ui.xml</span><span class="f_Para"> or </span><span class="f_Monospace">uimore.xml</span><span class="f_Para">) and to restart the Client. </span>
<span class="f_Para">Lets you [[Reconfiguring GUI buttons and hot keys#Using a Client command|assign a keyboard shortcut]] without having to edit a mapping file (</span><span class="f_Monospace">ui.xml</span><span class="f_Para"> or </span><span class="f_Monospace">uimore.xml</span><span class="f_Para">) and to restart the Client. </span>


'''Syntax:'''
'''Syntax:'''
Line 22: Line 22:


<span class="f_Para">Examples:  </span>
<span class="f_Para">Examples:  </span>
<p class="syntax"><span class="f_CodeExample">mapKey f2 Step </span><br />
<p class="syntax"><span class="f_CodeExample">mapKey f2 Step </span>
<span class="f_CodeExample">mapKey ALT-f2 stepover  </span><br />
<span class="f_CodeExample">mapKey ALT-f2 stepover  </span>
<span class="f_CodeExample">mapkey Ctl-f2 stepout  </span><br />
<span class="f_CodeExample">mapkey Ctl-f2 stepout  </span>
<span class="f_CodeExample">mapKey ALT-2 run </span>
<span class="f_CodeExample">mapKey ALT-2 run </span>
</p>
</p>

Revision as of 16:14, 6 December 2022

Action:

Lets you assign a keyboard shortcut without having to edit a mapping file (ui.xml or uimore.xml) and to restart the Client.

Syntax:

mapKey [modifier-]key command 

Where (case not important):

  • modifier is one of:  
    • alt maps the ALT-key version of a key combination (command runs when you hold down the Alt key and press the specified key)
    • cntrl,control, cntl, ctl, or ctrl maps the control key version of a key combination

modifier is optional, and its default is no modifier.

  • key is a keyboard key: a single letter or digit, or one of F2 through F12 (the function keys)
  • command is a Client command

Examples:  

mapKey f2 Step  mapKey ALT-f2 stepover   mapkey Ctl-f2 stepout   mapKey ALT-2 run 

After you execute the command, the new mapping is reflected immediately in the keyboard. The new mapping does not appear in the mapping file, and it does not remain if the Client is restarted.

The command to remove a keyboard shortcut mapping is clearKey. The command to map a Client button is mapButton.

Client menu: --
Introduced: Build 57