

                                    ScreenSelect
                                    ~~~~~~~~~~~~


                            Version:        1.0

                            Release date:   07-Sep-1992

                            Author:         Markus Aalto



*******************************************************************************
*                                                                             *
*   This program is freeware. You can freely distribute it as long as you     *
*   don't charge copying it more than nominal fee (max 3 US$) and no          *
*   additions/deletions/modifications is made to the original package. You    *
*   may include it to PD disks such as Fred Fish collection. This program     *
*   is distributed without warranty of any kind. So I take no responsibility  *
*   about this program, its documentation, functionality or damages it may    *
*   cause. The risk is entirely yours.                                        *
*                                                                             *
*******************************************************************************




1.  INTRODUCTION
~~~~~~~~~~~~~~~~

    ScreenSelect was programmed for users which commonly have more than two

or three screens open at the same time. It shows a list of screens and user

can then do double click selection to get wanted screen to front. It is

mainly designed to be used with public screens but it also works with normal

screens if wanted so. Only requirement is KS2.04 (V37) or greater. It is

implemented as a commodity and it also sports a font-independent interface.


2.  INSTALLATION
~~~~~~~~~~~~~~~~

    WB users could just put it to WBSTARTUP directory. 'DONOTWAIT'-tooltype

is already set in ScreenSelect's icon. So just drop it to WBStartup.


    CLI users could start it from S:User-Startup, so you first have to make

modifications to 'User-Startup'-file and then copy ScreenSelect somewhere

along the path (for example to 'C'-directory).


3.  TOOLTYPES & CLI OPTIONS
~~~~~~~~~~~~~~~~~~~~~~~~~~~

    ScreenSelect has normal commodity tooltypes + ALLSCREENS option. WB users

can use following options.


    CX_POPUP=TRUE|FALSE         -   this is optional. Default is FALSE.

    CX_PRIORITY=xxx             -   Default is 0. (xxx is decimal number ).

    CX_POPKEY=HOTKEY            -   Default is "shift esc". For example
                                    you could use 'CX_POPKEY=alt shift del' to
                                    change hotkey.

    ALLSCREENS=TRUE|FALSE       -   Flag which indicates which screens to
                                    use. Default is FALSE, so normally we
                                    use only public screens.


    CLI users have quite similar options.

    CX_POPUP                    -   This is a switch.

    CX_PRIORITY=xxx             -   Same as WB option.

    CX_POPKEY="HOTKEY"          -   Same as WB option, but remember to put
                                    '"' marks around HOTKEY name.

    ALLSCREENS                  -   This is a switch.


4.  USE
~~~~~~~

    After you have started ScreenSelect it normally disappears to background.

You can activate it by making hotkey selection (default 'shift esc'). When

activated ScreenSelect opens a window with a names of screens currently open.

By double-clicking one of the names in listview-gadget you can quickly

deactivate ScreenSelect and let it switch your selected screen to frontmost.

However it won't activate it for you. You still have to click in one window

in that screen. If you have selected one of the names in listview-gadget,

but not double-clicked, then by pressing 'Activate"-gadget ScreenSelect makes

screen switching operation. By pressing 'Cancel' or 'windowclose'-gadget you

get back to the screen you were after you activated ScreenSelect with hotkey.

You can quit ScreenSelect either with 'Quit'-gadget or Commodity Exchange

program's 'Kill'-gadget.


    There is also a 'Update'-gadget which scans through screens in you

system and updates listview. You can also toggle ALLSCREENS-flag by pressing

cycle gadget you can found below 'Update'-gadget. There should be reading

'Public Screens' or 'All Screens'.



5.  MISC
~~~~~~~~

    This is a common procedure ScreenSelect makes when it hears about hotkey

selection.

    --------------------------------------------------------

    if hotkey pressed then
        if active screen is public screen then
            lock it and open ScreenSelect window into it.
        else
            lock default public screen and open window to it.

    --------------------------------------------------------

    So this means that ScreenSelect window is not opened to foreign

applications screen. It's opened only to public screens. This may annoy

some users but I make this decision to make ScreenSelect more system

friendly. Remember that if you select new frontmost screen then there really

isn't much harm done. And even if you just press 'Cancel'-gadget you get

always back to you old frontmost screen.


    ScreenSelect also tries to make sure that all screen pointers passed

back to OS, are always valid. This is easy with public screens but requires

little more work with normal screens. I hope I got it right!


    Also there are programs which don't give any name to screen they open.

Screens like that are shown in listview as '( Nameless screen )'. I hope

that programmers would also specify a name for a screen, but I guess it just

isn't possible all the time.


    For suggestions, bug reports etc... You can reach me at

        Internet:   s37732v@vipunen.hut.fi

        or          Markus Aalto
                    Muurahaisentie 11a
                    01490 VANTAA
                    FINLAND


    ENJOY!



