Brass Plugins: Mime
Supported Directives: Keyboard
- Extended Keypress
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 "keyname" may be one of the following:
- F1
- F2
- F3
- F4
- F5
- F6
- F7
- F8
- F9
- F10
- ESC
- RET
- BKSP
- TAB
- HOME
- END
- PGUP
- PGDN
- LEFT
- RIGHT
- UP
- DOWN
- INS
- DEL
The keyname corresponds directly to what's on the keyboard, eg:
PGUP emulates a Page Up keypress.
Note that BKSP emulates the backspace key (the one above the Enter
key) and DEL emulates the Delete key (the one by the numeric keypad).
They are different keys and are not interchangeable.
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
keypress with virtual keys. 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.
|
