Events
======
Since v5.2 RK has a new group of functions called "Events".
The Timer was integreated in this group as "Time Events".
The old Shortcut function was replaced by "Keys Events"
and has more power now.
The old ABC (Auto Button Caller) function was replaced by
"Windows Events" and has also much more power now.
All functions of this family have a common feature: They
will respond to Windows events.
Event > Keys   : Will response to a keystroke (combination).
Event > Time   : Will response if a date/time has reached.
Event > Windows: Will response if a window comes to top (back)
Event > Other  : Will response to other events

Note! In FAQ text is an example how to use the event functions.


Event > Keys
============

How to open the "Event > Keys" requester
----------------------------------------
There are several possibilities available to open the Timer
requester.

- 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.EVENT.KEYS} or {/ME.POP.ALL} or {/ME.POP.REQUEST}
- By keystrokes [SHIFT]+[F9] (if RK has the focus and standard f-key
  assignment has not changed)


For what is the "Event > Keys" function useful?
-----------------------------------------------
With this function an assignable RK-button can be executed
by pressing a key (combination) on the keyboard.
It can be used as a shortcut function.


All On/Off
----------
In the left-top corner the function can be generaly switched
on/off. This is valid for all 20 Memories.
The popmenu point "Event > Keys" is checked, if it is switched
on.


Memory
------
Button up/down to select Memory 1-20 to display or/and edit.
The background color of the display showes, if the memory is
activ waiting for a keystroke to execute a button (green)
or if the Function/Memory is off (red).


Status of this Memory
---------------------
Function is off:
No execution because Function is switched off.

Memory is off:
No execution because Memory is switched off.

waiting:
Activ waiting for a keysstroke to execute a button.

No Key Selection:
No execution because entries not complete.


Combo-boxes "Profile" and "Button to execute"
---------------------------------------------
To choose the button to execute if a key is pressed. 1st.
choose Profile, 2nd choose the Button.


Key Assign for this Memory
--------------------------
On: To switch the execution of this Memory on/off.

Combo-box: To select if button execution at a normal key-
stroke or a keystroke combination [ALT]+[0] ...

Input-Line: To select a key on the keyboard, which will
response the button execution. If this line has the focus,
the user can press any key to assign this memory. Keys with-
out characters will be converted into their names (like {HOME}).

Number-display: This showes the key number on the keyboard.
Note! This is not the ASCII-code!


CLR-button
----------
To set a memory to default settings.


OK-button
---------
To save changes and close requester.


Cancel
------
To close requester without saving changes.



Event > Time (Timer)
====================


How to open the Timer requester
-------------------------------
There are several possibilities available to open the Timer
requester.

- 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.EVENT.TIME} or {/ME.POP.ALL} or {/ME.POP.REQUEST}
- By keystrokes [SHIFT]+[F10] (if RK has the focus and standard f-key
  assignment has not changed)


For what is the Timer useful?
-----------------------------
With the Timer of RK each of the 2500 buttons (left mouse
click plain only) can timer controlled executed.
Therefore you can time controlled open applications, showing
time requester, starting screen savers, running mouse click
scripts or what ever you want.
The Timer has 10 Memories. Each Memory can separately
assigned with a RK-button to execute.


Commands useful for Timer use
-----------------------------
/ME.EVENT.TIME ........: To open Timer requester
/APP.OPEN file[,par] ..: To open an application, file or url (with optional parameter)
/BTCH.BEEP.HOUR .......: To make hour controlled beeps
/BTCH.BEEP.ONE ........: To make one beep
/BTCH.BEEP.THREE ......: To make three beeps
/BTCH.MSG.AUTO sec ....: To open a requester that showes date, time for sec seconds
/BTCH.MSG.TEXT text ...: To open a requester that showes a message
/BTCH.MSG.TIME [text] .: To open a requester that showes date, time, kw and a message
/MCI.CD.PLAY ..........: To play CD
/MCI.STOP .............: To stop CD
/MCI.MIDI.PLAY file ...: To play midi file
/MCI.WAVE.PLAY file ...: To play wave file
/UserApp Ctrl, Date ...: To open Windows date/time requester


Timer requester:
================


All On/Off
----------
In the left-top corner the Timer can be generaly switched
on/off. This is valid for all 10 Timer Memories.
The popmenu point "Event > Time" is checked, if the Timer is
switched on.


Memory
------
Button up/down to select Memory 1-10 to display or/and edit.
The background color of the display showes, if the memory is
activ waiting for a predefined date to execute a button (green)
or if the Timer/Memory is off (red) or if the date has passed
(red).


Next Execution of this Memory
-----------------------------
Status, Function is off:
No execution because Timer is switched off.

Status, Memory is off:
No execution because Memory is switched off.

Status, waiting:
Activ waiting for the predefined date to execute a button.

Status, Date passed:
No execution because date has passed.

Day : Shows the day  of next execution (if waiting).
Date: Shows the date of next execution (if waiting).
Time: Shows the time of next execution (if waiting).


Combo-boxes "Profile" and "Button to execute"
---------------------------------------------
To choose the button to execute if the date has reached. 1st.
choose Profile, 2nd choose the Button.


Option
------
On: To switch the execution of this Memory on/off.

Ask before: To open an ask-requester before execution
  (execution? yes/no). Not available for Interval "Hourly".

Ask if passed: To execute a passed Memory, useful if RK was not
  running when the date has reached. Not available for Interval
  "Hourly" and "Daily".


Interval
--------
Hourly: To execute a button hourly.
  Select minute with "Time"-buttons.

Daily: To execute a button daily.
  Select hour/minute with "Time"-buttons.
  Days can be switched of if no execution wanted at this day(s).

Weekly: There is no option point available because this can be
  realized with "Daily". In this case only one day must be
  checked.

Monthly: To execute a button monthly.
  Select date/time with "Date/Time"-buttons.

Month2: To execute a button monthly.
  Select hour/minute with "Time"-buttons.
  This is not date based option but the combo-box under the
  days is enabled.
  1st. WDay: Execute at first workday of a month (Mo-Fr).
  Last WDay: Execute at last workday of a month (Mo-Fr).
  Last Day: Execute at last day of a month (28., 30., 31.)
  1st. Mo: Execute at first monday of a month.
  3rd. Sa: Execute at third saturday of a month (and so on).

Once: To execute a button one time.
  Select date/time with "Date/Time"-buttons.


Quick Message
-------------
A Message requester can be executed instead a button.
The message to view can be set in the text-line right
of this check box. The result is the same as command
{/BTCH.MSG.TIME [text]}
but is is faster to handle.


CLR-button
----------
To set a memory to default settings.


Now-button
----------
To set a memory to the actual date/time.


OK-button
---------
To save changes and close requester.


Cancel
------
To close requester without saving changes.



Event > Windows
===============

How to open the "Event > Windows" requester
----------------------------------------
There are several possibilities available to open the Timer
requester.

- 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.EVENT.WIN} or {/ME.POP.ALL} or {/ME.POP.REQUEST}
- By keystrokes [SHIFT]+[F11] (if RK has the focus and standard f-key
  assignment has not changed)


For what is the "Event > Windows" function useful?
--------------------------------------------------
With this function an assignable RK-button can be executed
if a predefined window comes to top (or goes to background).


All On/Off
----------
In the left-top corner the function can be generaly switched
on/off. This is valid for all 10 Memories.
The popmenu point "Event > Windows" is checked, if it is
switched on.


Memory
------
Button up/down to select Memory 1-10 to display or/and edit.
The background color of the display showes, if the memory is
activ waiting for a window to execute a button (green)
or if the Function/Memory is off (red).


Status of this Memory
---------------------
Function is off:
No execution because Function is switched off.

Memory is off:
No execution because Memory is switched off.

waiting:
Activ waiting for a window to execute a button.

No Win Title:
No execution because entries not complete.


Combo-boxes "Profile" and "Button to execute"
---------------------------------------------
To choose the button to execute if a window comes to top (goes to
background). 1st. choose Profile, 2nd choose the Button.


Window-Title Assign for this Memory
-----------------------------------

Window-Title (input line):
This line includes the window tiltle of the window, which will
response the button execution if it comes to top (or goes to the
background).

Options:
On: To switch the execution of this Memory on/off.
Case not sensitive: Normaly window titles are strong case-
   sensitive. That meens Windows will not recognize a window if
   there is a different in low- and uppercases. But with this
   option RK offers the possibility that the cases can be ignored.
Open/Close only: This offers the possibility to execute a button
   one time only if the window opens (i.e. after an exe-file was
   started). If this function is checked together with "Goes to
   Background", a button will executed if the application exit.

Joker for Window-Title:
If window titles changes joker can be set. I.e. if the title of a
window includes a project like "Hited [sample.txt]". In this case
the input line could include "Hited" and the joker could be
switched to "Right only".
Note! Donīt use joker in the input line like "Hited*"!

Execute if Window...:
The button execution can also responsed if a window goes to the
background or two times: If it comes to top and if it goes to the
background.

Window-State Condition:
In some cases a small requester has the same title like the main
application. Because in most cases the main application is maxi-
mized RK offers the possibility to response to the small
requester only. In this case "Normal only" must be checked.


CLR-button
----------
To set a memory to default settings.


OK-button
---------
To save changes and close requester.


Cancel
------
To close requester without saving changes.



Event > Other
=============

How to open the "Event > Windows" requester
----------------------------------------
There are several possibilities available to open the Timer
requester.

- 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.EVENT.OTHER} or {/ME.POP.ALL} or {/ME.POP.REQUEST}
- By keystrokes [SHIFT]+[F12] (if RK has the focus and standard f-key
  assignment has not changed)


For what is the "Event > Other" function useful?
------------------------------------------------
This function can execute an assignable button on different
events.


All On/Off
----------
In the left-top corner the function can be generaly switched
on/off. This is valid for all 10 Memories.
The popmenu point "Event > Other" is checked, if it is
switched on.


Memory
------
Button up/down to select Memory 1-10 to display or/and edit.
The background color of the display showes, if the memory is
activ waiting for the selected event to execute a button
(green) or if the Function/Memory is off (red).


Status of this Memory
---------------------
Function is off:
No execution because Function is switched off.

Memory is off:
No execution because Memory is switched off.

waiting:
Activ waiting for the selected event to execute a button.

No event selected:
No execution because entries not complete.


Combo-boxes "Profile" and "Button to execute"
---------------------------------------------
To choose the button to execute on selected event. 1st. choose
Profile, 2nd choose the Button.


Event assign for this Memory
----------------------------
On: To switch the execution of this Memory on/off.

Selected Event: To select the event from a combobox which will
cause the button execution.

Instruction line: Showes which setting the selected event needs

Input line: To enter the needed additional setting for this event.


Available event selections:
---------------------------
Clipboard-Text: Execution if the clipboard includes a specified text.
    Setting   : Text which will cause the execution.

No key/mouse activity: Execution if no key or mouse activity for a
                specified time.
    Setting   : Minutes without activity untill execution.

Offline (W9x) : Execution if system goes offline.
    Setting   : No.

Online (W9x)  : Execution if system goes online.
    Setting   : Minutes how long the system must be online untill the
                execution. Leave blank if execution without delay.

Since RK running: Execution if RemoteKeys is running for a specified
                time.
    Setting   : Minutes how long RK must be running untill the execution.

Since system running: Execution if system is running for a specified
                time.
    Setting   : Minutes how long system must be running untill the
                execution.


CLR-button
----------
To set a memory to default settings.


OK-button
---------
To save changes and close requester.


Cancel
------
To close requester without saving changes.


