Edit Keys
=========

Table of contents
-----------------
- How to open the Edit Keys dialog?
- Choose of the button to edit
- "OK" button
- Description of the Keys Edit dialog and how to assign a button
  - Button description frame
    - Name
    - Graphic
      - Output line
      - Select
      - CLR
    - Yellow help text (tool tip)
    - Dopple Width/Height
  - ASC/Code output in the right-top frame
  - Button Colors frame
    - Back- and Font Color
    - Small Letter box ["A"]
  - The Button assign area / Command list
    - 6 ways to fill the "Button assign" area
      - 1+2. Assign by the real keyboard and copy & paste
      - 3. Assign by "Drop"
      - 4. Assign by the "Rich" button
      - 5. Assign by the Key and command list, "Arrow-right" button
        - Group "Favorites"
      - 6. Assign by the Macro Recorder ("REC" button)
    - Copy, Delete, Co-ordinates & Disk button
    - Key-To-Command converter
  - L-R button
  - Encrypted
  - ¶ button
  - Survey
  - Tools button
  - Help button
  - Info button
  - Delete, Cut, Copy, Paste, Undo buttons
- How to move a button
- Quick copy


--> Tip
Quick copy is a hidden function of RK and very useful. Don´t
forget to read this chapter!


How to open the "Edit Keys" dialog
----------------------------------
There are several possibilities available to open the Keys Edit
dialog.

- By selecting from pull-down menu (open it with F1 before)
- By selecting from Systray popmenu
- By mouse click on a button which is assigned with
  {/ME.KEYS.EDIT} or {/ME.POP.ALL} or {/ME.POP.REQUEST}
- By click on an empty button
- With [Ctrl] + click on a button (most popular)
- By a right mouse click on a button which 2nd plain is empty
  (popmenu)
- By keystroke [F2] (if RK has the focus and standard f-key
  assignment has not changed)

--> Tip
To open the requester with [Ctrl] + click on mouse button
seems to be the fastest way to edit a button.

--> Tip
The Edit dialog form is resizeable!


Choose of the button to edit
----------------------------
If the Keys-Edit requester is open, one button on the RK panel
is shown with a flash light.
This flash light will show you which button is just in work.
That meens if you make any changes in the Keys Edit requester
the changes will be only valid for the button which is just
flashing.

To choose the button you wish to edit you must only click on
this button on RK panel while the Keys Edit requester is open.
That´s all. The reason why the mouse icon has the shape of a
hand will be discribed later and should not make you confuse.

You remember that each button has two planes which can be
assigned. One for the left and one for the right mouse button.
Think you have found the "L-R" button to choose on the Edit
dialog. A 2nd method to choose the plain is to click with the
right mouse button on the RK panel.


"OK" button
-----------
It is not required to close the Keys Edit requester by a click
on OK after the changes of one button has been made. You can
directly make changes at other buttons by selecting them (see
last chapter). Only if all button changes are ready you can
close the dialog by a click on OK.


Description of the Keys Edit dialog and how to assign a button
===============================================================

Button Description frame
------------------------

Name
----
In this line you make the entry of the word (or letters) you
will finally read on the button. The button lettering will be
changed in realtime.


Graphic
-------
Since v5.7 graphics (bmp, gif, jpg) can be added to the buttons
outfit. These images must be stored in the RK folder Profiles\
Images.
The gray output line includes the selected image name. To select
an image click on the select button and choose an image (if
exists) from the image folder. Because RK can not find images at
other places, the dir and path areas of the file box are
enabled. 
Use the CLR button to cancel the image presentation (of course the
image itsself will not be removed from disk).


Yellow help text (tool tip)
---------------------------
Because maybe the name of the button is to short to give enough
information about the function of this button, a tool tip can be
used which is shown if the mouse pointer stays on this button
for a while. In the Preferences requester you can choose if this
information will be shown as a typical tool tip or alternate
instead of the window title. This method if much faster. When
using borderless window, RK will automaticly switch to normal
tool tip text.
If this line is blanc the entry of the Button assign area will
be shown in the window title.


Dopple Width/Height
-------------------
The size of a single button can be set to a doppled width or/and
height as set in the edit profiles setting.

-> Hinweis
Wird doppelte Breite und doppelte Höhe gemeinsam eingestellt, so entsteht
in den meisten Fällen ein unschöner Farbrand in der rechten, unteren Ecke
des Knopfes. Dieses kann man umgehen, indem man für die verdeckten Knöpfe
die selbe Hintergrundfarbe als für den sichtbaren Knopf einstellt.


ASC/Key-Anzeige im rechten, oberen Rahmen
-----------------------------------------
Wird etwas in das Zuweisungsfeld geschrieben, so werden in diesen
Anzeigen jeweils der ASCII- und der Key-Code der gedrückten Taste
ausgegeben. Diese Werte benötigt man, wenn man die CODE-Commands
einsetzen möchte.
Beispiel: {/CODE.KEY 65}
Der Umschalter in diesem Rahmen gestattet die Anzeige der Maus-
Koordinaten. Diese Werte benötigt man, wenn man die MOUSE-Commands
einsetzen möchte. 
Beispiel: {/MOUSE.CLICK.LEFT 250,400}
In beiden Fällen braucht man die angezeigten Werte also nur noch
in die entsprechenden Commands einsetzen.


Back- and Font Color frame
--------------------------
Here you can adjust the outfit of the button. You can select
between 16 colors. 
Click on the 3-point buttons to have direct access to the
colors.

Small Letter box ["A"]
The small letter box shows how the button colors will be shown.


The "Button assign" area / Command list
---------------------------------------
The Button assign area will finally include the keystrokes which
will be send to the application. It can also include mouse click
order or internal RK functions.
You can use normally ASCII text or commands or both together.
Commands are set in brackets like this {}.


6 ways to fill the "Button assign" area
---------------------------------------
1. By using the real keyboard.
2. By copy and paste. This will copy the clipboard included text
   into this area.
3. By drag & drop from another application
4. By click on the "Rich" button (if available).
5. By copy a command from the "Key and Command list" into this
   area.
6. By using the Macro Recorder (if available).


1+2. Assign by the real keyboard and copy & paste
- - - - - - - - - - - - - - - - - - - - - - - - -
1+2: You can write or copy any ASCII text into the Button assign
area. Later, if you click on the assigned button of the RK
panel, this ASCII text will be send to the activated application
(which has the focus) like a word processor or email client.

3. By drag & drop from another application
- - - - - - - - - - - - - - - - - - - - - -
This option is available since v5.4.3.
The assign area is drop sensitive. It is possible to drag a text
from another application and drop down into the assign text area.
If it is a rich-text (i.e. drag from MS-Word), RK will auto-
maticly set the rich commands at beginning and end of the code.
If it is a file (i.e. drag from MS-Explorer), RK will auto-
maticly include the path into the APP.OPEN command.

4. Assign by the "Rich" button
- - - - - - - - - - - - - - - -
RK is able to handle rich-formated text. This format is i.e.
used by MS-Word and MS-Wordpad. If there is a rich text in the
clipboard (by copy from Word into the clipboard) the "Rich"
button is enabled to click. In this case all rich format
commands will be stored like color and font size commands.

5. Assign by the Key and command list, "Arrow-right" button
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
RK has more than 100 commands to navigate RK, open applications,
handle the clipboard, send special chars and much more. These
commands are discriped in the text file "Command List.txt".
Of course you can write the command by hand into the Button
assign area, but it is more easy to copy a command into the area
from the Key and command list. To do this you have 3 choices.

a. Select a command from the list and click on the "Arrow-right"
   button or
b. Doppleclick a command from the list or
c. drag an entry from the list and drop it into the assign area.

The command will be inserted at the cursor position of the
Button assign area (a+b) or added at the end (c).

In many cases you have to add a parameter to the command. The
command itself is always written in uppercases, the parameter in
lowercases and has to be replaced by your entry.
I.e. after copy the delay command you have this text in your
assign area:
{/BTCH.DELAY sec}
Now you must replace the parameter "sec" (seconds) by your
preset. If done it must be
look like this:
{/BTCH.DELAY 0.5}

Group "Favorites":
Because RK includes over 300 commands now, it needs a lot of
time to search often needed commands every time.
Therefore the user can manage his own favorites list.
By a click with the right mouse button on a command in the list,
he can add the selected command to the favorite list or he can
remove it.
Updater: Copy "profiles\favorite commands.dat" to your new
RK-installation to have furthermore your own favorites list
available.

6. Assign by the Macro Recorder ("REC" button)
- - - - - - - - - - - - - - - - - - - - - - - -
The macro recorder is discribed in the text file "Macro
Recorder.txt"


Copy, Delete, Co-ordinates & Disk button
----------------------------------------
Above the Button Assign Area, there are 4 buttons with a delete,
co-ordinate and a disk symbol.
The copy button is a quick possibility to copy the assign area into
the clipboard.
The delete button is a quick possibility to clear the assign area.
The co-ordinates button calculates a realive offset position for the
mouse commands. See Mouse.txt for details.
The disk button is useful for commands like APP.OPEN ..., to insert
a path into the command.


Key-To-Command converter
------------------------
To assign a button with keys like "cursor-down" you have to use
the suitable command.
In this case it is {KEY.DOWN}.
The converter is an alternate method to copy the command from
the list. If you select this checkbox you can directly press the
cursor-down key on your keyboard and it will be automatically
converted into the right command.

--> Note
Don´t forget to switch this function off after using!

--> Note
Under NT (only) the first bracket of {HOLD.SHIFT} will not be
generated and must be added by hand.


Encrypted
---------
The assign area included text can be encrypted, useful if there
are any passwords or secret dates included. RK will ask for a
password. This password is the en-/decrypt key and should be the
same for all buttons. If somebody clicks on an encrypted button
he must enter the password before RK sends the decrypted code to
an application. But this is required one time in a session only.
That meens the password will be automaticly unprotected after
the first request. If the user leave the computer he can protect
the password to prevent unauthorized use/view of protected data.

Note! Because it is also possible to encrypt commands there is a
trick to protect the password after each request. If the command
/ME.PW.PROTECT is added to the end of the script the password
will automaticly protected after the script execution.

Caution! If the password is lost it seems to be impossible to
regenerate the original code.


¶ button
--------
This showes if there is a curriage return at the end of the text.
In this case the textend character "¶" stands allone in the last
script line.
It is often an unwanted effect if a CR will be send at script end.


L-R button
----------
Each button has to planes which can be assigned. One for the
left and one for the right mouse button. By click on the L-R
button you can switch between both planes you wish to edit.

Since v7.4.35 the possibility to differ between plane 1 & 2 was
improved:

1. When selecting 2nd plane the button will stay in selected state
2. The backgroundcolor of the assign area is grey
3. If 2nd plane has datas, the button has a green background


Survey
------
Cancelled since v.7.4.01. Use Profile Explorer instead.


Tools button
------------
...offers a popup menu for selecting a few useful tools.

- ChangeColors: Helpful to find out color combinations for buttons
- CheckASC ...: Helpful to find out key and ASCII codes for CODE commands
- MouseMem ...: Helpful to generate mouse coordinates for MOUSE commands


Help button
-----------
..will open this text file.


Info button
-----------
..will show "How to use" messages.


Delete, Cut, Copy, Paste, Undo buttons
--------------------------------------
These buttons are valid for the button which is just in work.
They work like the known windows function but don´t use the
windows clipboard (too many different dates).
With cut, copy and paste you can copy or move a button to
another place. This place can also be on another profile.


How to move a button
--------------------
While the Edit Keys requester is open you can change the button
positions of the RK panel via drag and drop. Therefore the mouse
icon has the shape of a hand.
Dont´t be afraid to lost a button by overwriting! This function
will chanche button positions only, a to b and b to a.


Quick-Copy
----------
If you want to assign a button with a text module, several mouse
clicks are required.
Maybe to much work if you want to store a text for using in this
session only.
Quick-Copy offers a very fast way to assign a button with a
text. There are two Quick-Copy modes available. Mode one is for
popmenu use, mode two for drag & drop.

Mode one: popmenu
- - - - - - - - -
You only need a free button on your panel.
Click this button with the right mouse button. You get a popup
menu where you can paste the clipboard included text into the
assign area of this button. The name for this button will be
given automatically.
It is also possible to copy rich formated text.

If you have an internet address in your clipboard, RK will
automatically add the command to open the URL in Netscape or
IExplorer. Besides the automatically given name is not part of
the first letters because in this case all buttons would be
named as "htt".

Since v5.4.3 there is a new point called "Paste file". If there
is a path to a file in the clipboard, it will be automaticly
included into the APP.OPEN command.

It is also possible to clear the button assign with this
popmenu.
But in all cases the plane you reach with the right mouse button
must be free. Otherwise the button assign would be carry out.

Mode two: drag & drop
- - - - - - - - - - -
Since v5.4.3 the buttons of the RK panel are drop sensitive.
It is possible to drag a text, rich-text (MS-Word) or file (MS-
Explorer) and drop it over a button of RK. It works in the same
way like described under "Mode one".

--> Note!
Old assigns will be overwritten!