Clip History
============


Caution!
========
Clip History is a module of RemoteKeys.
This text is a part of the RemoteKeys manual.


How to open the Clip History Edit program
-----------------------------------------
There are several possibilities available to open the Clip
History 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.CLIP.HISTORY} or {/ME.POP.ALL} or {/ME.POP.REQUEST}
- By keystroke [F7] (if RK has the focus and standard f-key
  assignment has not changed)


What does the Clip History Program?
-----------------------------------
It scanns all text passages which are copied into the clipboard
by any applications (this happens in the background).
These passages are stored in two lists (combos). One is sorted
chronological, the other alphabetical.
If a text passage is needed which was copied into the clipboard
before, it can easyly copied to the clipboard by selecting the
item from one of the lists.
If not explicit saved on disk, the lists will be cleared after
program finished.

--> Note!
Since v7.5 this module was new coded and exported from RK to an
independent application (to relieve RK main program).
This should not have any effects in using it as usual. The program
can still be called by the systray popmenu or CLIP.HISTORY command.
If this program is not running, RK will scann the clipboard
instead (if the function is not disabled in preferences).

--> Note
The window size can be horizontal enlarged.
The last wondow position before program finish will be saved on
disk for the next use of this program.


En-/disable this function
-------------------------
(Valid for RK only!)
If there are conflicts with other applications, the clipboard
scanning can be switched off in proferences of RK.
But this has no effect for clipboard scanning of this program.
If this is also unwanted, the program must be closed.


Edit the clipboard
------------------
The long line which shows the clipbaord included text is edit-
able. After [Enter] the changes are copied into the clipboard.
[ESC] = undo.


Combo-Boxes und manual clipboard edit
-------------------------------------
The 2 combo boxes, which can be opened right of the edit line,
includes the history lists. The left one is chronoligical, the right
one alphabetical sorted.
By a click on an item of the list, the content will be copied into
the clipboard and into the edit line. This line can manually changed.
After confirmation with [Enter], the changed text will be copied
into the clipbaord and to the history lists.

-> Note
The combo boxes can handel 1024 characters for each item only.
But internal the program is able to handel items without limitation.
This is one point the program was improved contrary the old program
code.


"Copy to Clipboard" -Button
---------------------------
This button will copy the text line into the clipboard and has the
same effect as pressing [Enter].


File/Clear Clipboard
--------------------
To clear clipboard and edit line.


File/New (Clear History List & Clipboard)
-----------------------------------------
To clear the History-Lists (Combos) and the Clipboard.


File/Open, Save
---------------
The History-List can be saved in a fix-namend file (Save) or append
at the end of this file (Save - Append).
"Open" will replace the lists with the file content, but "Open - add
to current list" will add the file content at the end of the current
list content.


File/Clear File Content
-----------------------
To clear the file content.


File/Editor
------------
To open the file with the standard editor.


File/Hide
---------
Since Clip History is an separate program, it has an own program icon
in the systray. With "Hide" the program will hide in the systray and
can be recalled by a click onto this systray icon.
Additional the icon has a small popup menu (hide & quit).


File/Quit
---------
To quit the program.


Edit/Cut spaces and CR from left & right (Trim)
-----------------------------------------------
This will remove spaces, line feeds and carriage returns at the
beginning and the end of the clipboard text.


Edit/Remove Characters
----------------------
Offers a dialog to remove characters from the clipboard. In the upper
line, the clipboard text is shown, in the lower line, the user can
define the charaters to remove from the clip. Changes will be shown
instandly, but the changes will be valid only after a click on OK.


Edit/Replace Characters
-----------------------
Offers also a dialog to define the characters to replace. There are
4 preset fields which will be automaticly saved and loaded. They can
be switched on if needed.


Edit/Convert to Upper Cases
---------------------------
To change the text of the clipboard into upper cases.


Edit/Covert to Lower Cases
--------------------------
To change the text of the clipboard into lower cases.


Settings/Maximum Combo Items
----------------------------
Allows to limit the combo item quantity at less memory space.


Settings/Start-Mode/Normal, Minimized, Hidden (in Systray)
----------------------------------------------------------
Here the user can adjust, in which mode RK will be opend. This can be
useful if RK should be start with the Windows-Autostart-folder when
system boots up.


--> Note
If calling by RK, the program will be always opened in "Normal" mode and
the mode-setting can not be changed.


Settings/Language
-----------------
To choose the language (English, German, French).

--> Note
If calling by RK, the lanuage will be set automaticly to the same
language setting of RK.


Info/About...
-------------
Showes the info dialog of this program.


Info/Help for this window
-------------------------
Showes the manual of this program (this text).
