Ereignisse
==========


Seit v5.2 besitzt RK eine neue Funktions-Gruppe mit der
Bezeichnung "Ereignisse". Der Timer wurde in diese Gruppe
unter der Bezeichnung "Ereignis > Zeit" integriert.
Die alte Shortcut-Funktion wurde durch "Ereignis > Tasten"
ersetzt und ist nun erheblich leistungsstärker.
Die alte ABC (Auto Button Caller) wurde durch "Ereignis > Fenster"
ersetzt und ist nun ebenfalls erheblich leistungsstärker.
Alle Funktionen dieser Familie haben etwas gemeinsam:
Sie reagieren auf sogenannte "Windows Ereignisse" (Events),
zumindest im weiteren Sinne.
Ereignis > Tasten : Reagiert auf Tastenanschläge
Ereignis > Zeit   : Reagiert auf das Erreichen eines Datums/Zeit.
Ereignis > Fenster: Reagiert auf das Öffnen/Schließen von Fenstern
Ereignis > Weitere: Reagiert auf weitere Ereignisse

--> Beachte!
Bitte bedenken, daß das Abfragen von Ereignissen System-Resourcen
(Rechenleistung) beanspruchen muß. Bei Normalbeanspruchung des
Rechners sollte dies zwar keine nennenswerte Rolle spielen, aber im
Zweifelsfall kann man ja auch einen Task-Monitor zu Hilfe nehmen und
entsprechende Tests bei ein- und ausgeschalteten Ereignis-Funktionen
durchführen.
Das selbe betrifft übrigens auch die in den Einstellungen ausschalt-
bare Funktion "Merkoption der Zwischenablage", die Änderungen in der
Zwischenablage speichert, um die Informationen dem Programm Clip-
History (Speicher für Zwischenablage) beim Aufruf zur Verfügung zu
stellen.

--> Beachte!
Im FAQ-Text ist ein Beispiel (in englischer Sprache) angegeben,
wie die Ereignis-Funktionen eingesetzt werden.


=================
Ereignis > Tasten
=================

Wie wird der "Ereignis > Tasten"-Requester geöffnet?
----------------------------------------------------
Hierfür gibt es mehrere Möglichkeiten.

- Durch Anwahl im Pull-Down Menü (zuvor mit F1 öffnen)
- Durch Anwahl im Systray-Popmenü
- Durch einen Mausklick auf einen Knopf, der mit einem der
  folgenden Commands belegt ist:
  {/ME.EVENT.KEYS} oder {/ME.POP.ALL} oder {/ME.POP.REQUEST}
- Durch die Tasten [Shift]+[F9] (sofern RK den Fokus besitzt
  und die Standard F-Tasten-Belegung nicht geändert wurde)


Wozu dient die "Ereignis > Tasten"-Funktion?
--------------------------------------------
Durch diese Funktion kann ein belegbarer RK-Knopf durch eine
Taste bzw. Tastenkombination ausgelöst werden.
Sie kann als eine Art Shortcut-Funktion angesehen werden.


Alle Ein/Aus
------------
In der linken oberen Ecke des Fensters kann die Funktion
generell ein- bzw. ausgeschaltet werden. Dies gilt also für
alle 20 verfügbaren Speicherplätze.
Der Menü-Punkt "Ereignis > Tasten" ist bei eingeschalteter
Funktion mit einem Häkchen versehen.


Speicher(-plätze)
-----------------
Mit den "Pfeil-auf/-ab"-Tasten werden die Speicherplätze angewählt,
um die Werte anzuzeigen und deren Editierung zu ermöglichen.
Die Hintergrundfarbe des Displays gibt Auskunft über den Status des
Speicherplatzes. "Grün" bedeutet, daß er aktiv auf eine Tastenbe-
tätigung wartet, um einen Knopf auszuführen. "Rot" indes, daß die
Funktion bzw. der Speicherplatz ausgeschaltet ist.


Status dieses Speicherplatzes
-----------------------------
Funktion ist aus:
Keine Durchführung, da die Funktion ausgeschaltet ist.

Speicher ist aus:
Keine Durchführung, da der Speicherplatz ausgeschaltet ist.

Bereit:
Aktiv wartend auf eine Tastenbetätigung um einen Knopf auszuführen.

Keine Taste gewählt:
Keine Durchführung, da Zuweisung noch nicht vollständig.


Combo-Boxen "Profil" und "Auszuführender Knopf"
-----------------------------------------------
Ermöglicht die Festlegung des Knopfes, der beim Drücken einer Taste
ausgeführt wird. Als erstes ist das Profil, als zweites der Knopf
auszuwählen.


Tasten-Zuweisung eines Speicherplatzes
--------------------------------------
Ein: Schaltet den Speicherplatz ein/aus.

Combo-Box: Ermöglicht die Auswahl, ob der Aufruf durch normale
Tastenbetätigung oder durch eine Tastenkombination geschieht
[ALT]+[0] ...

Eingabe-Zeile: Auswahlt der Taste, die das Ereignis auslöst um
einen belegbaren RK-Knopf auszuführen. Wenn diese Zeile den Fokus
besitzt, kann der Anwender dem Speicherplatz eine Taste zuweisen,
indem er sie drückt. Zeichenlose Tasten werden in deren Namen
konvertiert (z.B. {HOME} für Pos 1).

Nummern-Anzeige: Zeigt die Tasten-Nummer an.
Beachte! Dies ist nicht der ASCII-Code!


"Löschen"-Knopf
---------------
Setzt den Speicherplatz auf Vorgabewerte.


"OK"-Knopf
----------
Speichert die Einstellungen und schließt den Requester.


"Abbrechen"-Knopf
-----------------
Schließt den Requester ohne Speicherung der Einstellungen.



=======================
Ereignis > Zeit (Timer)
=======================


Wie wird der "Timer"-Requester geöffnet?
----------------------------------------
Hierfür gibt es mehrere Möglichkeiten:

- Durch Anwahl im Pull-Down-Menü (zuvor mit F1 aufklappen)
- Durch Anwahl des Punktes im Systray-Popmenü
- Durch Klick auf einen Knopf, der mit einem der
  folgenden Commands belegt ist:
  {/ME.EVENT.TIME} oder {/ME.POP.ALL} oder {/ME.POP.REQUEST}
- Durch die Tasten [Shift]+[F10] (sofern RK den Fokus besitzt
  und die Standard F-Tasten-Belegung nicht geändert wurde)


Wozu dient der Timer?
---------------------
Mit dem Timer kann jeder der 2500 belegbaren Knöpfe (gilt nur
für die mit der rechten Maustaste erreichbaren Ebene) zu einem
vorbestimmten Zeitpunkt ausgelöst werden.
Somit können zeitgesteuert Programme geöffnet, Requester ange-
zeigt, Mausklicks durchgeführt werden u.s.w.
Der Timer besitzt 10 Speicherplätze, die jeweils einen separat
definierbaren Knopf auslösen können.


Nützliche Commands für den Timer-Gebrauch
-----------------------------------------
/ME.EVENT.TIME ........: Öffnet den "Timer"- Requester
/APP.OPEN file[,par] ..: Öffnet eine Anwendung, Datei oder URL
/BTCH.BEEP.HOUR .......: Macht eine der Uhrzeit entsprechende Anzahl "Beeps"
/BTCH.BEEP.ONE ........: Macht einmal "Beep"
/BTCH.BEEP.THREE ......: Macht dreimal "Beep"
/BTCH.MSG.AUTO sec ....: Zeigt einen Requester mit Datum und Zeit an
/BTCH.MSG.TEXT text ...: Zeigt einen Requester, der die Meldung <text> ausgibt
/BTCH.MSG.TIME [text] .: Zeigt einen Requester mit Datum, Zeit, KW und Meldung an
/MCI.CD.PLAY ..........: Startet die Audio-CD
/MCI.STOP .............: Stoppt die Audio-CD
/MCI.MIDI.PLAY file ...: Spielt eine Midi-Datei
/MCI.WAVE.PLAY file ...: Spielt eine Wave-Datei
/UserApp Ctrl, Date ...: Öffnet den Windows Datum/Zeit Einstell-Requester


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


Alle Ein/Aus
------------
In der linken oberen Ecke kann der Timer generell ein- und aus-
geschaltet werden. Dies betrifft also alle 10 Speicherplätze.
Ist der Timer eingeschaltet, so ist der Systray-Popmenü-Eintrag
mit einem Häkchen versehen. 


Speicher(-plätze)
-----------------
Mit den "Pfeil-auf/-ab"-Tasten werden die Speicherplätze angewählt,
um die Werte anzuzeigen und deren Editierung zu ermöglichen.
Die Hintergrundfarbe des Displays gibt Auskunft über den Status des
Speicherplatzes. "Grün" bedeutet, daß er aktiv auf einen Termin
wartet, um einen Knopf auszuführen. "Rot" indes, daß der Timer bzw.
der Speicherplatz ausgeschaltet ist oder der angegebene Termin be-
reits überschritten ist.


Nächste Ausführung (dieses Speicherplatzes)
-------------------------------------------
Status, "Funktion ist aus":
Keine Ausführung, da der Timer ausgeschaltet ist.

Status, "Speicher ist aus":
Keine Ausführung, da der Speicherplatz ausgeschaltet ist.

Status, "bereit...":
Aktiv wartend auf einen Termin um einen Knopf auszuführen.

Status, "Termin überschr.":
Keine Ausführung, da der Termin überschritten ist.

Tag  : Zeigt den Tag   der nächsten Ausführung.
Datum: Zeigt das Datum der nächsten Ausführung.
Zeit : Zeigt die Zeit  der nächsten Ausführung.



Combo-Boxen "Profil" und "Auszuführender Knopf"
-----------------------------------------------
Ermöglicht die Festlegung des Knopfes, der bei Erreichung des
Termins ausgeführt wird. Als erstes ist das Profil, als
zweites der Knopf auszuwählen.


Optionen
--------
Ein: Schalten den Speicherplatz ein bzw. aus.

Vorher Info: Zeigt vor der Ausführung eines Knopfes eine Sicher-
  heitsabfrage an (Ausführen ja/nein?).
  Nicht verfügbar für Intervall "Stündlich".

Info: Vorbei: Ermöglicht die Ausführung eines Knopfes bei bereits
  überschrittenem Termin. Dies ist sinnvoll, wenn RK bei Erreichen
  des Termins nicht lief.
  Nicht verfügbar für Intervall "Stündlich" und "Täglich".


Intervall
---------
Stündl.: Um einen Knopf stündlich auszuführen.
  Minute einzustellen mit den "Zeit"-Knöpfen.

Täglich: Um einen Knopf täglich auszuführen.
  Stunde/Minute einzustellen mit den "Zeit"-Knöpfen.
  Tage können ausgeschaltet werden, an denen keine Ausführung
  stattfinden soll.

Wöchentlich: Hierfür gibt es keine separate Anwahl, da dies mit
  der Einstellung für "Täglich" realisiert werden kann. Hierzu
  alle Tage ausschalten bis auf einen.

Monatl.: Um einen Knopf monatlich auszuführen.
  Tag/Zeit einzustellen mit den "Datum/Zeit"-Knöpfen.

Monatl.2: Um einen Knopf monatlich auszuführen.
  Stunde/Minute einzustellen mit den "Zeit"-Knöpfen.
  Diese Einstellung ist im Vergleich zur erstgenannten nicht
  datums-, sondern wochentags-orientiert. Die Combo-Box unter
  den Tagen ist nun freigeschaltet.
  1st. WDay: Ausführung am 1. Wochentag des Monats (Mo-Fr)
  Last WDay: Ausführung am letzten Wochentag des Monats (Mo-Fr)
  Last Day : Ausführung am letzten Tag des Monats (28., 30., 31.)
  1st. Mo  : Ausführung am 1. Montag des Monats.
  3rd. Sa  : Ausführung am 3. Sonnabend des Monats (u.s.w.)

Einmalig: Um einen Knopf einmalig auszuführen.
  Tag/Zeit einzustellen mit den "Datum/Zeit"-Knöpfen.


Kurz-Mitteilung
---------------
Anstelle der Ausführung eines Knopfes kann bei Erreichen des ein-
gestellten Termins ein Mitteilungs-Requester geöffnet werden.
Die anzuzeigende Mitteilung kann in der Eingabezeile rechts
neben dem Schalter dieser Funktion eingetragen werden ("Linden-
straße fängt an!").
Das Ergebnis ist das selbe, als würde man einen Knopf mit dem
Command {/BTCH.MSG.TIME Lindenstraße fängt an!} ausführen, doch
ist die Handhabung dieser Funktion erheblich einfacher und
schneller.


"Löschen"-Knopf
---------------
Setzt den Speicherplatz auf Vorgabewerte.


"Akt.-Zeit"-Knopf
-----------------
Setzt den Speicherplatz auf das aktuelle Datum/Zeit.


"OK"-Knopf
----------
Speichert die Einstellungen und schließt den Requester.


"Abbrechen"-Knopf
-----------------
Schließt den Requester ohne Speicherung der Einstellungen.



==================
Ereignis > Fenster
==================

Wie wird der "Ereignis > Fenster"-Requester geöffnet?
-----------------------------------------------------
Hierfür gibt es mehrere Möglichkeiten.

- Durch Anwahl im Pull-Down Menü (zuvor mit F1 öffnen)
- Durch Anwahl im Systray-Popmenü
- Durch einen Mausklick auf einen Knopf, der mit einem der
  folgenden Commands belegt ist:
  {/ME.EVENT.WIN} oder {/ME.POP.ALL} oder {/ME.POP.REQUEST}
- Durch die Tasten [Shift]+[F11] (sofern RK den Fokus besitzt
  und die Standard F-Tasten-Belegung nicht geändert wurde)


Wozu dient die "Ereignis > Fenster"-Funktion?
---------------------------------------------
Durch diese Funktion kann ein belegbarer RK-Knopf durch das Er-
scheien bzw. Verschwinden eines zuvor definierten Fensters ausgelöst
werden.


Alle Ein/Aus
------------
In der linken oberen Ecke des Fensters kann die Funktion
generell ein- bzw. ausgeschaltet werden. Dies gilt also für
alle 10 verfügbaren Speicherplätze.
Der Menü-Punkt "Ereignis > Fenster" ist bei eingeschalteter
Funktion mit einem Häkchen versehen.


Speicher(-plätze)
-----------------
Mit den "Pfeil-auf/-ab"-Tasten werden die Speicherplätze angewählt,
um die Werte anzuzeigen und deren Editierung zu ermöglichen.
Die Hintergrundfarbe des Displays gibt Auskunft über den Status des
Speicherplatzes. "Grün" bedeutet, daß er aktiv auf ein Fenster
wartet, um bei dessen Erscheinen einen Knopf auszuführen. "Rot"
indes, daß die Funktion bzw. der Speicherplatz ausgeschaltet ist.


Status dieses Speicherplatzes
-----------------------------
Funktion ist aus:
Keine Durchführung, da die Funktion ausgeschaltet ist.

Speicher ist aus:
Keine Durchführung, da der Speicherplatz ausgeschaltet ist.

Bereit:
Aktiv wartend auf ein Fenster um einen Knopf auszuführen.

Kein Fenstertitel:
Keine Durchführung, da Zuweisung noch nicht vollständig.


Combo-Boxen "Profil" und "Auszuführender Knopf"
-----------------------------------------------
Ermöglicht die Festlegung des Knopfes, der beim Erscheinen eines
Fensters ausgeführt wird. Als erstes ist das Profil, als zweites der
Knopf auszuwählen.


Fenstertitel-Zuordnung dieses Speicherplatzes
---------------------------------------------
Fenstertitel (Eingabezeile):
Hier wird der Fenstertitel des Fensters eingegeben, das beim Er-
scheinen (bzw. Verschwinden) die Knopf-Ausführung auslösen soll.

Optionen:
Ein: Schaltet den Speicherplatz ein/aus.
Groß-/Klein nicht beachten: Normalerweise sind Fenstertitel streng
   "case-sensitive", d.h. wenn Unstimmigkeiten in der Groß- und
   Kleinschreibung auftreten, erkennt Windows das Fenster nicht.
   Ist diese Option aktiviert, spielt die Groß-/Kleinschreibung
   keine Rolle mehr. 
Nur beim Öffnen/Schließen: Dies ermöglicht die Ausführung darauf
   zu beschränken, daß das Fenster geöffnet werden muß, was ja z.B.
   bei einem Programmstart der Fall ist. Ist diese Option zusammen
   mit "In den Hintergrund geht" eingeschaltet, so wird die Aus-
   führung z.B. beim Beenden eines Programmes ausgelöst.

Joker (Platzhalter) für F´titel:
Wenn Fenster ihre Titel ändern, können Joker eingesetzt werden,
damit sie dennoch erkannt werden. Wenn beispielsweise ein Programm
den Projektnamen im Titel mit angibt ("Hited [sample.txt]"),
so kann der Fenstertitel mit "Hited" spezifiziert und zusätzlich
die Joker-Option "Nur Rechts" eingeschaltet werden.
Beachte! Keine Jokerzeichen im Fenstertitel verwenden ("Hited*")!

Ausführen wenn Fenster...
Die Knopf-Ausführung kann - wie erwähnt - auch ausgelöst werden,
wenn das oben spezifizierte Fenster in den Hintergrund geschaltet
wird. Auch zweimalige Ausführung ist möglich, wenn das Fenster
erscheint und wenn es wieder verschwindet.

Bedingung für Fensterstatus:
In manchen Fällen hat ein kleiner Requester den selben Fenstertitel
als die Hauptanwendung. Da in den meisten Fällen die Hauptanwendung
maximiert ist, bietet RK hier ein Unterscheidungskriterium an.
In diesem Falle wäre also "Nur bei Normal-Größe" anzuwählen, damit
die Ausführung nur bei Erscheinen des kleinen Requesters ausgelöst
wird.


"Löschen"-Knopf
---------------
Setzt den Speicherplatz auf Vorgabewerte.


"OK"-Knopf
----------
Speichert die Einstellungen und schließt den Requester.


"Abbrechen"-Knopf
-----------------
Schließt den Requester ohne Speicherung der Einstellungen.



==================
Ereignis > Weitere
==================

Wie wird der "Ereignis > Weitere"-Requester geöffnet?
-----------------------------------------------------
Hierfür gibt es mehrere Möglichkeiten.

- Durch Anwahl im Pull-Down Menü (zuvor mit F1 öffnen)
- Durch Anwahl im Systray-Popmenü
- Durch einen Mausklick auf einen Knopf, der mit einem der
  folgenden Commands belegt ist:
  {/ME.EVENT.Other} oder {/ME.POP.ALL} oder {/ME.POP.REQUEST}
- Durch die Tasten [Shift]+[F12] (sofern RK den Fokus besitzt
  und die Standard F-Tasten-Belegung nicht geändert wurde)


Wozu dient die "Ereignis > Weitere" Funktion?
---------------------------------------------
Dies Funktion kann Knöpfe auf unterschiedliche eintretende
Ereignisse ausführen.


Alle Ein/Aus
------------
In der linken oberen Ecke des Fensters kann die Funktion
generell ein- bzw. ausgeschaltet werden. Dies gilt also für
alle 10 verfügbaren Speicherplätze.
Der Menü-Punkt "Ereignis > Weitere" ist bei eingeschalteter
Funktion mit einem Häkchen versehen.


Speicher(-plätze)
-----------------
Mit den "Pfeil-auf/-ab"-Tasten werden die Speicherplätze angewählt,
um die Werte anzuzeigen und deren Editierung zu ermöglichen.
Die Hintergrundfarbe des Displays gibt Auskunft über den Status des
Speicherplatzes. "Grün" bedeutet, daß er aktiv auf das gewählte Er-
eignis wartet um einen Knopf auszuführen. "Rot" indes, daß die
Funktion bzw. der Speicherplatz ausgeschaltet ist.


Status dieses Speicherplatzes
-----------------------------
Funktion ist aus:
Keine Durchführung, da die Funktion ausgeschaltet ist.

Speicher ist aus:
Keine Durchführung, da der Speicherplatz ausgeschaltet ist.

Bereit:
Aktiv wartend auf das Eintreten des gewählten Ereignisses um einen
Knopf auszuführen.

Ereignis wählen!:
Keine Durchführung, da Zuweisung noch nicht vollständig.


Combo-Boxen "Profil" und "Auszuführender Knopf"
-----------------------------------------------
Ermöglicht die Festlegung des Knopfes, der bei dem gewählten Ereignis
ausgeführt wird. Als erstes ist das Profil, als zweites der Knopf
auszuwählen.


Ereignis-Zuweisung dieses Speicherplatzes
-----------------------------------------
Ein: Schaltet den Speicherplatz ein/aus.

Gewähltes Ereignis: Hier wird das Ereignis gewählt, daß die Knopf-
Ausführung auslösen soll.

Instruktions-Zeile: Zeigt an, welcher Parameter für das gewählte
Ereignis erforderlich ist.

Eingabe-Zeile: Hier wird der zusätzliche erforderliche Parameter
für das gewählte Ereignis eingegeben.


Verfügbare Ereignisse, die (z.Z.) zur Auswahl stehen:
-----------------------------------------------------
Keine Tasten-/Maus-Betätigung: Ausführung, wenn nach einer vorgegeben
               Zeit keine Tasten- oder Maus-Betätigung erfolgt.
   Parameter : Angabe der Minuten, wie lange keine Betätigung
               erfolgen darf, bis es zur Ausführung kommt.

Online (W9x) : Ausführung, wenn das System online geht.
   Parameter : Angabe der Minuten, wie lange das System online sein
               muß, bis es zur Ausführung kommt. Bei sofortiger Aus-
               führung kann die Eingabe-Zeile freigelassen werden.

Offline (W9x): Ausführung, wenn das System offline geht.
   Parameter : Keine.

Seit RK läuft: Ausführung, wenn RemoteKeys eine vorgegebene Zeit
               läuft.
   Parameter : Angabe der Minuten, wie lange RK laufen muß, bis es zur
               Ausführung kommt.

Seit System läuft: Ausführung, wenn System eine vorgegebene Zeit
               läuft.
   Parameter : Angabe der Minuten, wie lange das System laufen muß,
               bis es zur Ausführung kommt.

Text in der Zwischenablage: Ausführung, wenn in der Zwischenablage ein
               vorgegebener Text erscheint.
   Parameter : Der Text, der die Ausführung auslöst.


"Löschen"-Knopf
---------------
Setzt den Speicherplatz auf Vorgabewerte.


"OK"-Knopf
----------
Speichert die Einstellungen und schließt den Requester.


"Abbrechen"-Knopf
-----------------
Schließt den Requester ohne Speicherung der Einstellungen.
