Brass Plugins: Mime
Supported Directives: Keyboard
- Extended Keypress by Virtual Keys
This directive sends one single extended keypress
to the target application. Please read the very important technical
note at the bottom of this page.
The format of the directive is:
{keyname}
The curly braces are what separates these virtual key directives
from the standard extended key directives, which use square braces.
The "keyname" may be one of the following:
| Keyname |
Emulated
Key |
|
Keyname |
Emulated
Key |
| ESC |
Escape |
|
RET |
Return/Enter |
| PGDN |
Page Down |
|
PGUP |
Page Up |
| HOME |
Home |
|
END |
End |
| LEFT |
Left arrow key |
|
RIGHT |
Right arrow key |
| UP |
Up arrow key |
|
DOWN |
Down arrow key |
| INS |
Insert |
|
DEL |
Delete |
| SPACE |
Space bar |
|
|
|
| |
|
|
|
|
| NP0 |
Numpad 0 |
|
NP1 |
Numpad 1 |
| NP2 |
Numpad 2 |
|
NP3 |
Numpad 3 |
| NP4 |
Numpad 4 |
|
NP5 |
Numpad 5 |
| NP6 |
Numpad 6 |
|
NP7 |
Numpad 7 |
| NP8 |
Numpad 8 |
|
NP9 |
Numpad 9 |
| |
|
|
|
|
| NPMUL |
Numpad * (multiply) |
|
NPDIV |
Numpad / (divide) |
| NPADD |
Numpad + (add) |
|
NPSUB |
Numpad - (subtract) |
| NPDEC |
Numpad . (decimal point) |
|
|
|
| |
|
|
|
|
| F1 |
F1 key |
|
F2 |
F2 key |
| F3 |
F3 key |
|
F4 |
F4 key |
| F5 |
F5 key |
|
F6 |
F6 key |
| F7 |
F7 key |
|
F8 |
F8 key |
| F9 |
F9 key |
|
F10 |
F10 key |
| F11 |
F11 key |
|
F12 |
F12 key |
| F13 |
F13 key |
|
F14 |
F14 key |
| F15 |
F15 key |
|
F16 |
F16 key |
| F17 |
F17 key |
|
F18 |
F18 key |
| F19 |
F19 key |
|
F20 |
F20 key |
| F21 |
F21 key |
|
F22 |
F22 key |
| F23 |
F23 key |
|
F24 |
F24 key |
| |
|
|
|
|
| BRWBACK |
Browser
Back |
|
BRWFWD |
Browser
Forward |
| BRWRFRS |
Browser
Refresh |
|
BRWSRH |
Browser
Search |
| BRWSTOP |
Browser
Stop |
|
BRWFAV |
Browser
Favourites |
| BRWHOME |
Browser
Home |
|
|
|
| |
|
|
|
|
| OEM1 |
";:" key on US keyboards |
|
OEM2 |
"/?" key on US keyboards |
| OEM3 |
"`~" key on US keyboards |
|
OEM4 |
"[{" key on US keyboards |
| OEM5 |
"\|" key on US keyboards |
|
OEM6 |
"}]" key on US keyboards |
| OEM7 |
'" (single, double quote) key |
|
|
|
| OEMPLUS |
"+" key for all keyboards |
|
OEMCOMMA |
"," key for all keyboards |
| OEMMINUS |
"-" key for all keyboards |
|
OEMPERIOD |
"." key for all keyboards |
Many more keys are available in this directive than in the standard
extended key directive due to the different way the directives emulate
keypresses. Microsoft include a large number of keys that really
don't exist on most keyboards, but they are emulated here just in
case.
The yellow-background keys in the above table are multimedia keys
from specific keyboards. They most likely will not function in normal
applications or on systems without the multimedia keyboards installed.
Feel free to try them if you think you need them anyway.
Each extended key directive must be separated by a %% delimiter.
Examples
Send "Brass is great!", press the Enter key, and "I
love it!" to an application
Brass is great!%%{RET}%%I
love it!
Emulate pressing Page Up 5 times
{PGUP}%%{PGUP}%%{PGUP}%%{PGUP}%%{PGUP}
Technical Notes
This directive should be self explanatory. The
keypress is emulated in the target application.
IMPORTANT: You should be aware that some
applications have a different way of handling extended keys. Windows
provides a number of different methods to get input into an application.
An application can choose to handle just one of those methods. This
means that sometimes the extended key directives don't appear to
work.
In these cases you will configure an action and
create the directive for it. When you make the associated gesture
you will see that the gesture is recognised but either nothing happens
or some corrupt output appears on-screen.
In these cases you should switch to using extended
keypresses. This is not a bug or fault in Mime, it's just the
way the application has been written. Using the alternative extended
keys method will fix the problem.
You can reproduce this problem easily with Notepad.
Pressing F1 in Notepad opens the Help docs. Create an action with
a directive of [F1] and try making the gesture. The gesture is recognised
but nothing happens. Now change the directive to {F1} and test it
again. This time the directive works. Now create a final action
with a directive of [RET]. When you make the gesture, a new line
is added just as if you pressed the Return key.
|
