             !KeyLoad (C) Bernard Veasey 1998-2003 version 0.11
                        >>> G I F T W A R E <<<
                     Email: bernard@bapfish.org.uk
                    Web: http://www.bapfish.org.uk/

DESCRIPTION
-----------
!KeyLoad was made so that a pre-determined list of files, applications
and directories etc could be located and loaded by keypresses as well as by
using a mouse.


INSTALLATION
------------
Just 'drag' !KeyLoad to your hard disc.


INSTRUCTIONS
------------
Drag a Filer 'object(s)' to the 'KeyLoad' window to add it/them to the
'KeyLoad' object list.  Filer objects can be from different discs etc.

Page through the list using the mouse or arrow keys and click 'Run' or
press RETURN to 'Run' the selected object.

To search for an object in the 'KeyLoad' object list, put the caret in the
Search icon by clicking in it or by pressing f4, enter the search criteria
and press RETURN.  The first match will be displayed.  If nothing is found
you will hear a beep.  If more than one match is found you can use the
'right' arrow key to do a 'next match' and the 'left' arrow key to do a
'last' match.


ICONBAR ICON CONTROLS
---------------------
'Select'           Opens 'KeyLoad' window.
'Adjust'           Closes 'KeyLoad' window.
                   Regains input focus to enable opening of main window
                   using the KeyLoad Hot Key which by default is f2.
'Menu'             Opens 'KeyLoad' menu.


CONTROLS
--------
** mouse **

 UP arrow          Proceed UP list.
 SHIFT/UP arrow    Proceed UP list by ten.
 CTRL/UP arrow     Proceed to beginning of list.

 DOWN arrow        Proceed DOWN list.
 SHIFT/DOWN arrow  Proceed DOWN list by ten.
 CTRL/DOWN arrow   Proceed to end of list.

 RUN (select)      Run contents.
 RUN (adjust)      Run contents and keep 'KeyLoad' window open.
 DELETE            Delete current object.
 SHIFT/DELETE      Delete ALL objects.

 Menu item         Select the clicked menu item.

** keys **

 UP arrow          Proceed UP list.
 SHIFT UP arrow    Proceed UP list by ten.
 PageUP            Proceed UP list by ten.
 CTRL UP arrow     Proceed to beginning of list.

 DOWN arrow        Proceed DOWN list.
 SHIFT DOWN arrow  Proceed DOWN list by ten.
 PageDOWN          Proceed DOWN list by ten.
 CTRL DOWN arrow   Proceed to end of list.

 LEFT arrow        Proceed down 'found' list.
 RIGHT arrow       Proceed up 'found' list.

 RETURN            Run contents.
                   If the caret is in the 'Search' icon, a search is
                   implemented.
 CTRL/RETURN       Run contents and keep the 'KeyLoad' window open.
 SHIFT/RETURN      Same as SHIFT 'Running' a Filer object in RISC OS.
 CTRL f2           Close 'KeyLoad' window and lose 'Input Focus'.
 DELETE            Delete current object.
 SHIFT/DELETE      Delete ALL objects.
 f2  (Hot Key)     Open (or close) the main 'KeyLoad' window.  This is the
                   KeyLoad Hot Key which can be changed in the KeyLoad
                   Options window.
 f3                Saves the current 'list' of objects.
 f4                Search - Puts caret in the 'Search' icon.

 Please note that 'KeyLoad' needs to have the 'input focus' for the above
 keypresses (except the Hot Key - f2) to work.  When the main 'KeyLoad'
 window is opened it has the 'input focus'.  If it loses the 'input focus'
 by another application grabbing it, clicking on the 'Keyload' iconbar icon,
 the main 'KeyLoad' window or pressing the KeyLoad Hot Key gives 'KeyLoad'
 the 'input focus' again.  When 'KeyLoad' has the 'input focus' its title
 bar is coloured yellow.


ICONBAR and KEYLOAD WINDOW MENU
-------------------------------
Info            Opens the 'About this program' window.
Options         Opens the 'Options' window.
Save            Saves the current 'list' of objects.
Quit            Quit this program.
                If the 'Iconbar icon' option is off and the 'KeyLoad'
                window is closed, you can quit 'KeyLoad' from the RISC OS
                Task Manager window.


OPTIONS WINDOW
--------------
Open on startup    Sets the 'Open on startup' option on/off.
                   When set to 'on', the main 'KeyLoad' window is opened
                   automatically when !KeyLoad is first run.

Sort               If selected, will perform a sort on the 'KeyLoad' list
                   when next loaded or an additional object is dragged to
                   the 'KeyLoad' window.

Iconbar icon       Toggles display of the 'KeyLoad' iconbar icon.

Auto save          If set the 'KeyLoad' object list file is automatically
                   saved after a file(s) has been dragged to the main
                   'KeyLoad' window or when an object has been deleted.

Show pathnames     If set, objects in the 'KeyLoad' object list show as
                   much of their pathnames as possible.

Auto close         If set, the main 'KeyLoad' window will automatically
                   close after a 'KeyLoad' object has been 'Run'.

Speech             If set and if there is a Speech module loaded, KeyLoad
                   will speak the currently selected KeyLoad Object name.

Vertical wrap      If set, when paging through the 'KeyLoad' object list
                   the first and last items will wrap around.

Hot Key            This is the KeyLoad Hot Key code that opens and closes
                   the main KeyLoad window.  Just press the key you
                   require and the key code will automatically be entered
                   in the icon.  By default it is 386 which is f2.
                   NB. Function keys are probably best used including the
                   use of SHIFT, CTRL and CTRL/SHIFT with the desired key.

SAVE               Saves the current 'KeyLoad' options, the KeyLoad Hot Key
                   code and the position of the 'KeyLoad' window.



GENERAL INFORMATION
-------------------
When a change has been made to the 'list', a star is placed to the right
of the !KeyLoad window title showing that it needs to be saved.

The SPRITE relating to the currently selected object in the 'KeyLoad'
object list is shown in the top left of the main 'KeyLoad' window.

The number displayed in the main 'KeyLoad' window is the position within
the 'KeyLoad' object list.


=============================================================================
ABOUT GIFTWARE
--------------
This program is giftware, not public domain.  Giftware means that if you
use this program regularly you are asked to send the author a 'gift'.

By sending a gift, your support helps to provide updates to this program
and an incentive for other RISC OS software to be developed.

To make a gift and register
---------------------------
Please send your chosen amount (10ukp suggested)
(eg. 10 pound note or cheque payable to Bernard Veasey) to:

    Mr B Veasey
    24 Drift Road
    Bognor Regis
    West Sussex
    PO21 3NS
    UK

Upgrades
--------
The current site to obtain the latest version is from:

    http://www.bapfish.org.uk/


End-User licence conditions
---------------------------
You may give a copy of this software to a friend but you may only
distribute this software from your web site or on a CD-ROM or similar
device in bulk with the express permission of the author.

Disclaimer of liability
-----------------------
1. The software is supplied 'as is' the Author makes no warranty, whether
   express or implied, as to the merchantability of this software or its
   fitness for any particular purpose.

2. In no circumstances will the Author be liable for any damage, loss of
   profits, goodwill or for any indirect or consequential loss arising out of
   your use of the Software, or inability to use the Software, even if the
   Author has been advised of the possibility of such loss.

3. The author reserves the right to change the specification of this program
   without notice.


Bug Reports and Suggestions
---------------------------
Bug reports and suggestions will be welcome from all users, even if you have
not made a gift (yet).

Please enclose the following information:

    Computer:

    RISC OS version:

    Software version: 

    Problem/Suggestion:

    Any other relevant information:

and contact me by Email at:

    bernard@bapfish.org.uk
    ~~~~~~~~~~~~~~~~~~~~~~

Other Software by Bernard can be found at:

    http://www.bapfish.org.uk/
    ~~~~~~~~~~~~~~~~~~~~~~~~~~
