Short:    Add hotkeys for screens. V1.2.
Author:   Magnus Holmgren (cmh@lls.se)
Uploader: Magnus Holmgren (cmh@lls.se)
Type:     util/cdity


Introduction
============

This is a small program I hacked together the other day (hence the brief
documentation ;). It is a small commodity that allows you to add hotkeys
for any screen (that have a title). When you press the hotkey, the screen
in question is brought to the front.

There are two versions of the programs included, ScreenKeys and
ScreenKeys_OS3. The difference is that the latter requires OS 3.0 or
better, and is a tad smaller (about 600 bytes). Apart from that, they
should be equivalent.


Usage
=====

ScreenKeys only supports Workbench startup at the moment. Thus, you should
install ScreenKeys in your WBStartup drawer. The following tooltypes are
available:

CX_PRIORITY
	The priority for the hotkeys.

SCREENKEY
	This tooltype describes the screen and the hotkey for that screen.
	Any number of SCREEKEY tooltypes may be present. First specify the
	pattern describing the screen title, and after that - separated by
	spaces or an equal sign - the hotkey for that screen. If a screen
	pattern or a hotkey contains spaces, quote it. A screen pattern or
	hotkey should not be more than 256 chars, or it will be truncated
	(or an error occurs; I haven't checked ;).

	If a pattern match several screens, and SCREENTOBACK is specified,
	then ScreenKeys will cycle between the matching screens. Thus,
	specifying the screen pattern "#?" will behave the same way as the
	"lcommand m" key. See the included icon for further examples.

	Example: SCREENKEY="Workbench screen" "lcommand w"

SCREENTOBACK
	If this tooltype is present, then the formerly frontmost screen
	will be brought to the back, after the new front screen has been
	brought forward. This is needed to get the screen cycling to work.
	However, there are a few problems with this.

	First of all, it can sometimes be convenient if this doesn't
	happen. Secondly, it doesn't work too well with the attached
	screens in OS 3.0+ (and I don't know of any way to find out if two
	screens are attached or not). With this tooltype you can decide how
	ScreenKeys should behave. If this tooltype isn't specified, then the
	screen cycling will only work for two screens.

The DONOTWAIT tooltype in the icon is for the Workbench, when placed in the
Workbench startup drawer.


Author and other things
=======================

ScreenKeys was written in 1995 by Magnus Holmgren. It is public domain
(source included, though not very well documented ;), so you can do
anything you like with it (although credits would be appriciated ;).
Contact address:

Snail mail:

	Magnus Holmgren
	Kvarnbergsvägen 5
	S-444 47  Stenungsund
	SWEDEN

Electronic mail:

	cmh@lls.e
	cmh@augs.se
	2:204/204.6@fidonet


Version history
===============

	1.0	December 8, 1995

		Initial release.

	1.1	December 9, 1995

		Forgot to reply the Workbench startup message. ;)

	1.2	December 17, 1995

		SCREENTOBACK tooltype added.

		Sigh. Forgot to reply Commodity messages. ;)

		Didn't close icon.library.

		Some minor (size) optimizations.


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
     463     195 57.8% 09-Dec-95 15:22:32  DMakeFile
    3316    2275 31.3% 17-Dec-95 18:34:04  ScreenKeys
   10945    3964 63.7% 17-Dec-95 15:13:54  ScreenKeys.c
    3012    1286 57.3% 17-Dec-95 15:21:42  ScreenKeys.info
    3135    1529 51.2% 17-Dec-95 14:39:52  ScreenKeys.readme
    2123     945 55.4% 08-Dec-95 12:56:40  ScreenKeys.readme.info
    2688    1787 33.5% 17-Dec-95 18:33:46  ScreenKeys_OS3
    3012    1284 57.3% 17-Dec-95 15:22:06  ScreenKeys_OS3.info
-------- ------- ----- --------- --------
   28694   13265 53.7% 18-Dec-95 10:58:00   8 files