Description of Keys & Commands
==============================
Note: English translation still under construction!

Command-Group "ME": Steuerung von RK
====================================

RK ist so aufgebaut, daß es sich vollständig mit Knöpfen, die mit Commands
dieser Gruppe belegt sind, steuern läßt. Ursprünglich besaß RK keine Menü-
Leiste, da man eine solche mit entsprechend angeordneten RK-Knöpfen simulieren
kann.
Ein Beispiel für eine solche Leiste befindet sich im "Manual"-Profil, das beim
ersten Programm-Start von RK angezeigt wurde (siehe dort die oberste Knopf-
Reihe). Aber selbtverständlich kann man die mit ME-Commands versehenen Knöpfe
nach belieben auf dem RK-Fenster plazieren. Der obligatorische "opt"-Knopf,
der sich in der linken, oberen Ecke eines jeden Profils befindet, ist in
Wahrheit auch nichts anderes, als ein mit einem ME-Command ausgestatteter
RK-Knopf (/ME.POP.OPTION in diesem Fall).
Überhaupt sollte man sich die Knopf-Belegungen des "Manual"-Profils einmal
näher ansehen, indem man die Knöpfe mit gedrücktgehaltener [Strg]-Taste
anklickt.


/ME.ABOUT .............: To open RemoteKeys Info dialog
------------------------
Example: {/ME.ABOUT}


/ME.ACTIVATE ..........: To activate RK (focus), useful for Event > Keys
------------------------
Example: {/ME.ACTIVATE}


/ME.AUTOEXECUTE .......: To execute this button when profile is selected from (systray-) popmenu
------------------------

Example: {/ME.AUTOEXECUTE}

--> Note
If "Store" profile is selected an automatic user message will be showen.
This was relized with this command which is placed in the "note" button.


/ME.BORDER.OFF ........: To switch RemoteKeys to window border off mode
/ME.BORDER.ON .........: To switch RemoteKeys to window border on mode
/ME.BORDER.SWITCH .....: To switch RemoteKeys between window border on and off mode
------------------------
The Boarder-Mode has its own description.
After first start RK is switched in BORDER.ON mode.

Example: {/ME.BORDER.OFF}


/ME.BUTTON prof,but[,lv] To execute button <but> of profile <prof>, optional level <lv> (0/1)
------------------------
This command can execute another button.
This can be useful after development of several small buttons which should be
connected to one big automation.
Additional it is possible to define buttons which are present in other profiles.
The parameter is not case sensitive and will not distinguish between "My Profile,
My Button" and "my profile,my button".

Example: {/ME.BUTTON store,rknet}

same as 

Example: {/ME.BUTTON store,rknet,0}

but

Example: {/ME.BUTTON store,rknet,1}

executes the 2nd level which can be normally executed with the right mouse button.

--> Beachte
Es wurde festgestellt, daß ein mit dem ME.BUTTOM Command aufgerufener Knopf, der
ebenfalls einen ME.BUTTON Command beinhaltet, zu Profil-Schalt-Fehlern führt.
Dies kann umgangen werden, indem der Command {/ME.PROF.SWITCH no} in das Skript
integriert wird, wobei in <no> die Nummer des aktuellen Profils eingetragen werden
muß.


/ME.CALENDAR ..........: To open calendar window
------------------------
This is an information window only.
Nothing can be set, especially the system date & time of the computer will not be
changed.

Example: {/ME.CALENDAR}


/ME.CLICKHIDE.ON ......: To switch "Hide after a Button-Click" on
/ME.CLICKHIDE.OFF .....: To switch "Hide after a Button-Click" off
------------------------
Example: {/ME.CLICKHIDE.ON}


/ME.CLIP.HISTORY ......: To open the external program "Clip History"
------------------------
This program has its own description.

Example: {/ME.CLIP.HISTORY}


/ME.CLIP.MON [calc] ...: To open the Clip Monitor, optional <calc>=2 for calculator use
/ME.CLIP.MON.DEC ......: To open the Clip Monitor in Decimal Mode
/ME.CLIP.MON.HEX ......: To open the Clip Monitor in Hex Mode
------------------------

Example: {/ME.CLIP.MON}


/ME.COLOR.EDIT ........: To open the external ChangeColors program
/ME.COLOR.REFRESH .....: To load the colors.dat, useful when ChangeColors finished
------------------------
"Change Colors" has its own description.

Example: {/ME.COLOR.EDIT}


/ME.CTRL.ID ...........: To view requester ID ..
/ME.CTRL.REFRESH ......: To refresh language changes
------------------------
This command is useful only for developers of RK translations into other
languages.
"Edit Language" has its own desctiption.


/ME.EVENT.KEYS ........: To open Event > Key dialog
/ME.EVENT.TIME ........: To open Event > Time dialog
/ME.EVENT.WIN .........: To open Event > Window dialog
/ME.EVENT.OTHER .......: To open Event > Other dialog
------------------------
"Event" functions have there own description.

Example: {/ME.EVENT.KEYS}


/ME.EVENT.TIME.OFF ....: To switch Time Event function generally off
/ME.EVENT.WIN.OFF .....: To switch Window Event function generally off
------------------------
This command can de-activate "Event" functions without open the "Event"
user interfaces.

Example: {/ME.EVENT.TIME.OFF}


/ME.FKEYS .............: To open F-Keys dialog
/ME.FKEYS.RELOAD ......: To reload F-Key assignments
/ME.FKEYS.SURVEY ......: To view F-Keys survey
/ME.FKEYS.TEMP-OFF ....: To switch F-Key assignments temoprary on/off
------------------------
The F-Keys assignment is valid only if RK has the focus.

Example: {/ME.FKEYS}
Example: {/ME.FKEYS.RELOAD}
Example: {/ME.FKEYS.SURVEY}
Example: {/ME.FKEYS.TEMP-OFF}

The TEMP-OFF command is a switch.
Call it again to swap the state from on > off > on...
The state will not be saved on disk. Everytime RK starts the state is "on".


/ME.FONT.SLCT .........: To select a font for RemoteKeys panel
/ME.FONT.NORMAL .......: To switch RemoteKeys to the default font
------------------------
Der Zeichensatz, mit dem die RK-Knöpfe beschriftet werden, kann global geändert
werden.
Wenn in den Profil-Einstellungen unter Schriftgröße "Vorg." (= Vorgabe) ein-
getragen ist, so ist die dortige Einstellung abhängig von dem global einge-
stellten Schriftgrad.

Example: {/ME.FONT.SLCT}


/ME.HIDE ..............: To hide RemoteKeys
------------------------
Dieser Command bewirkt das selbe, als wenn auf das Schließ-Symbol des RK-
Fensters geklickt wird, sofern in den Einstellungen
"Schließsymbol > RK verbergen" aktiviert ist. Wenn sich RK im Systray
verbirgt, kann man es durch einen Klick auf das Systray-Icon wieder
auf den Bildschirm zurückholen.
Interessant könnte dieser Command sein, wenn man nach Ausführung einer
Automation RK vom Bildschirm verschwinden lassen möchte, indem man
diesen Command an das Ende des Skriptes setzt.

Example: {/ME.HIDE}


/ME.IMAGE.MEMORY ......: To open the external program "ImageMemory"
------------------------
This program has its own description
and can also be opened by selecting from pop and systray menu.

Example: {/ME.IMAGE.MEMORY}


/ME.KEYS.EDIT .........: To open the Keys Edit dialog
------------------------
Der vollständigkeitshalber gibt es natürlich auch einen Command um das gar
so wichtige "Bearbeiten > Knöpfe"-Fenster zu öffnen, es sei aber empfohlen,
das Fenster mit einem Mausklick auf den linken Mausknopf auf einen der RK-
Knöpfe, bei gleichzeitig gedrückter [Strg]-Taste zu öffnen.

Example: {/ME.KEYS.EDIT}


/ME.MANUAL ............: To open the Manual.exe application
------------------------
Öffnet das im Hauptordner von RK bedindliche Manual.exe-Programm, mit dem
Du Dir vermutlich just in diesem Moment diesen Text durchliest.

Example: {/ME.MANUAL}

-> Beachte
Ab v7.4.31 schaltet sich das Programm automatisch auf die aktuell eingestellte
Sprache.


/ME.MEMOPAD ...........: To open the external MemoPad
------------------------

Example: {/ME.MEMOPAD}

--> Caution
MemoPad uses the profile and button numbers to identify the different file names.
Therefore profile order changes will be corrected and button moves will be stoped.


/ME.MENU.SWITCH .......: To switch the pull-down menu on/off
------------------------
Wer aus Gewohnheitsgründen eine Menü-Leiste im RK-Fenster haben möchte,
kann diese mit diesem Command ein- bzw. ausschalten.
Alle dort befindlichen Menü-Punkte lassen sich aber über das Systray-
Pop-Menü sowie diesen ME-Commands aufrufen.

Example: {/ME.MENU.SWITCH}


/ME.MINIMIZE ..........: To minimize the RemoteKeys window
------------------------
Minimiert das RK-Fenster in gleicher Weise, als wenn der Windows-Minimier-
Knopf des Fensters in der rechten, oberen Ecke angeklickt wird.

Example: {/ME.MINIMIZE}


/ME.MOUSEHIDE .........: To open Hide on Mouse Position dialog
------------------------
Die "Bei Maus-Position Verbergen"-Funktion besitzt einen eigenen Beschreibungs-
text der in dieser Anleitung mit "RK durch Mausklick öffnen" betitelt ist.

Example: {/ME.MOUSEHIDE}


/ME.POP.ALL ...........: To view systray popmenu, complete
/ME.POP.CD ............: To view CD control popmenu
/ME.POP.LANGUAGE ......: To select language of RK
/ME.POP.OPTION ........: To view systray popmenu, profiles and edit dialogs
/ME.POP.PROF ..........: To view systray popmenu, profiles only
/ME.POP.REQUEST .......: To view systray popmenu, all dialogs only
/ME.POP.STATE .........: To view systray popmenu, state commands like hide.. only
------------------------
Mit den POP-Commands, die alle etwas unterschiedliche RK-Funktionen zusammen-
fassen, läßt sich komfortabel durch die Menü-Struktur von RK navigieren.
Es sei an dieser Stelle nur an das OPTION-Menü verwiesen, das in jedem Profil
in Gestalt des "Opt"-Knopf vorbelegt ist.
Viele weitere Beispiele finden sich im "Manual"-Profil in der obersten
Knopfreihe.
Das "ALL"-Menü entspricht z.B. dem des Systray-Popmenüs.

Example: {/ME.POP.ALL}


/ME.POP.USERAPP .......: To view User-Application popmenu
------------------------
Das USERAPP-Popmenü ist ein selbstbelegbares Menü um Anwendungen zu starten,
deren Einträge sich in der im Profiles-Ordner befindlichen UserApp.dat-Datei
definieren lassen. Ein mit diesem Command vorbelegter Knopf befindet sich
im "Manual"-Profile im UserApp-Knopf.

Example: {/ME.POP.USERAPP}


/ME.PREFS .............: To open Preferences dialog
------------------------

Example: {/ME.PREFS}


/ME.PROF.BACK .........: To switch to the last selected profile
------------------------
Dieser Command kann nützlich sein, möchte man zum vorher angezeigten
Profil zurückkehren, ohne sich um Nummern und Namen scheren zu wollen.

Example: {/ME.PROF.BACK}


/ME.PROF.INC ..........: To open the next profile
/ME.PROF.DEC ..........: To open the previous profile
------------------------
Mit diesen Commands kann man auf das folgende bzw. vorhergehende Profil schalten,
wobei sich die Profil-Schaltung nach den Profil-Nummern richtet (1-10).
Z.B. mit dem INC-Command von Profil-Nummer 3 auf Nummer 4. u.s.w.

Example: {/ME.PROF.INC}


/ME.PROF.EDIT .........: To open Profile Edit dialog
------------------------
Die "Profil bearbeiten"-Funktion besitzt einen eigenen Beschreibungstext.
Bevorzugt wird man dieses Fenster aber sicher aus den Popmenüs der "Opt"-Knöpfe
öffnen.

Example: {/ME.PROF.EDIT}


/ME.PROF.EXPLORER [p] .: To open the Profile Explorer, optional: switch to profile number <p>
------------------------

Example: {/ME.PROF.EXPLORER}
Example: {/ME.PROF.EXPLORER 5}


/ME.PROFSET.RELOAD ....: To reload the Profiles.dat
------------------------

Example: {/ME.PROFSET.RELOAD}

User-Example:

{/BTCH.EXPLICIT}
{/DSK.RENAME profiles\profiles.dat,profiles9.dat}
{/DSK.RENAME profiles\profiles1.dat,Profiles.dat}
{/DSK.RENAME profiles\profiles9.dat,profiles1.dat}
{/ME.PROFSET.RELOAD}

This example swaps between 2 profiles.

--> Caution !
There is no check if everything works okay. If the script will not finish,
it could happen, that one script will be overwritten by another one.
Therefore it is recommend to make a backup of the profiles.dat before
trying this sample.


/ME.PROF.SWITCH no ....: To open a fixed profile number (<no> = 1-10)
------------------------
This command allowes to switch to a profile by its profile number (1-10)

Example: {/ME.PROF.SWITCH 5}


/ME.PROF.TMP.COL [v] ..: To change column quantity temporary to <v>, current profile only (default VAR)
/ME.PROF.TMP.ROW [v] ..: To change row quantity temporary to <v>, current profile only (default VAR)
/ME.PROF.TMP.HIGH [v] .: To change button height temporary to <v>, current profile only (default VAR)
/ME.PROF.TMP.WIDE [v] .: To change button width temporary to <v>, current profile only (default VAR)
/ME.PROF.TMP.RESET.ALL : To reset temporary changes to saved settings, all profiles
/ME.PROF.TMP.RESET.PROF: To reset temporary changes to saved settings, current profile only
------------------------
Mit diesen Commands können die Dimensionen von Profilen temporär geändert werden, d.h.
die Änderungen werden nicht gespeichert und entsprechen spätestens nach dem nächsten Programm-Start
von RK wieder dem, was im Bearbeiten > Profil Dialog eingestellt wurde.
Da durch Weglassen des Parameters <v> die Variable VAR einspringt, können Änderungen auch
"schrittweise" vorgenommen werden.

Example:

Knopf, Ebene 1 (linke Maus-Taste):

{/BTCH.EXPLICIT}
{/VAR.<.PROF 0}    ' VAR auf die aktuelle Spalten-Anzahl setzen (Parameter=0)
{/VAR.ADD 1}       ' VAR um eins erhöhen
{/ME.PROF.TMP.COL} ' temp. Spalten-Anzahl auf VAR setzen

Knopf, Ebene 2 (rechte Maus-Taste):

{/BTCH.EXPLICIT}
{/VAR.<.PROF 0}
{/VAR.SUB 1}
{/ME.PROF.TMP.COL}

Bei jedem Klick auf diesen Knopf mit der linken Maus-Taste erhöht sich die Spalten-Anzahl um jeweils
eine Spalte, bis der Maximal-Wert von 25 Spalten erreicht ist.
Entsprechend vermindert ein Klick mit der rechten Maus-Taste die Spalten-Anzahl um 1.

-> Tip
Der ME.PROF.RESET.PROF Command kann auch dazu verwendet werden, wenn das RK-Fenster nach einer
Verschiebung wieder auf seine ursprünglich gespeicherten Koordinaten positioniert werden soll.
ME.PROF.TMP.RESET.ALL löscht hingegen alle vorübergehend gespeicherten Koordinaten-Zeiger.



/ME.PROF2.INC .........: To open the previous profile without changing the window position
/ME.PROF2.DEC .........: To open the next profile without changing the window position
------------------------
Mit diesen Commands kann man eine "2. Funktionsebene" der RK-Knöpfe simulieren,
wie man sie z.B. von funktionsreichen Rechnern oder Handys her kennt und die
dort gemeinhin als 2nd-Function-Tasten bezeichnet werden.

Da es diese 2. Funktionsebene in Wirklichkeit garnicht gibt, bedient man sich
einfach eines anderen Profils, das exakt die selben Fenster-Dimensionen
aufweisen sollte; also auch die Anzahl der Knopf-Spalten und Zeilen.
Ferner muß das Profil der 2. Funktionsebene um eine Nummer höher oder
niedriger liegen als das der 1. Ebene.

Der PROF2.INC-Command schaltet nun nicht nur auf das nächst höhere Profil, so
wie es der normale PROF.INC-Command macht, sondern sorgt zusätzlich dafür,
daß sich die Bildschirm-Position des RK-Fensters nicht ändert.

Und der 2. Effekt dieser Funktion: Nachdem ein Knopf der 2. Funktionsebene an-
geklickt wurde, schaltet RK automatisch auf die 1. Ebene zurück.

Das Profil der 2. Funktionsebene sollte einen Knopf aufweisen, der mit dem
"PROF.BACK"-Command belegt ist, damit man bei irrtümlicher Anwahl der 2. Ebene
bequem wieder zur 1. Ebene zurückkehren kann.

Example: {/ME.PROF2.INC}


/ME.PROFCENTER ........: To open Profile Center dialog
------------------------
The "Profile-Center" has its own description.

Example: {/ME.PROFCENTER}


/ME.PROFSET.SWAP ......: To swap between profile set 1 & 2
------------------------
Dieser Command hat die selbe Wirkung, als wenn im Systray-Popmenu der oberste
Punkt "Swap Profile-Set" angewählt wird.
Nähere Erläuterungen siehe auch "Profile-Set #2.txt".

Example: {/ME.PROFSET.SWAP}


/ME.PW.ENTER ..........: To enter the crypt password
/ME.PW.PROTECT ........: To protect the crypt password
------------------------
Auf die Paßwort-Funktion wird im Beschreibungstext "Knöpfe bearbeiten" im
Abschnitt "Verschlüsselt" näher eingegangen.
Normalerweise fordert RK das Paßwort vom Anwender an, wenn es einen
paßwort-kodierten Knopf ausführen soll und merkt sich dieses für die Dauer
der Session um lästige Neueingaben zu vermeiden.
Mit dem PW.ENTER-Command kann man RK nun auch ohne Ausführung eines kodierten
Knopfes das Paßwort (zum Merken) mitteilen.
Mit dem "PW.PROTECT"-Command veranlaßt man RK sozusagen dazu, daß Paßwort
wieder zu vergessen, was eine Neueingabe beim Klick auf einen kodierten Knopf
zur Folge hätte.
Beide Funktionen kann man auch aus dem Systray-Popmenü mit dem Menü-Punkt
"Crypt-Paßwort" sperren auslösen. Hier wird je nach augenblicklichem
Zustand das Paßwort entweder freigegeben oder gesperrt.


/ME.QUIT ..............: To exit RemoteKeys
------------------------

Example: {/ME.QUIT}


/ME.README ............: To open the readme file
------------------------

Example: {/ME.README}


/ME.RKNET .............: To open RK-network program
------------------------
The "RKNet" program has its own description.

Example: {/ME.RKNET}


/ME.SHOW ..............: To open RK window
------------------------
Dieser Command ist im Zusammenwirken der "Ereignis > Tasten"-Funktion (Hotkeys)
sinnvoll, um das RK-Fenster per Tastendruck aus dem Systray auf den Bildschirm
zu befördern.


/ME.SURVEY ............:
------------------------
This function was replaced by the Profile Explorer since v7.3.
ME.SURVEY has the same effect as ME.PROF.EXPLORER.


/ME.TEXTVIEWER-OPT n ..: To change int. text viewer setting: <n>=1:maximize, 2:white bg, 3:no close but, 4:10"
------------------------
Hiermit kann das Ausgabe-Fenster z.B. des Commands {/CLIP.TXT.VIEW} beeinflußt werden:
Die Einstellung muß natürlich vor dem Aufruf des Betrachters vorgenommen werden und
bleibt für die Dauer der RK-Session bestehen, sofern sie nicht erneut geändert wird.

Parameter:

n=0: Alle Einstellungen werden gelöscht
n=1: Das Fenster wird maximiert geöffnet
n=2: Die Hintergrund-Farbe des Textfensters ist weiß (statt grau)
n=3: Kein "Close"-Knopf im Textfenster (Alternativ Windows Schließ-Knopf [x])
n=4: 10" Schriftgröße anstatt 12"


/ME.TOUR ..............: To open the external RK-Tour program
------------------------
Opens the Tour program which is placed in the RK mainfolder.

Example: {/ME.TOUR}
