OVERVIEW:

wIconifyWindow is a companion program to wIconify.  It allows you to to
request (from the CLI) that a window be iconified, and also allows you to
specify the icon's new position and some flags that control its functions
within wIconify.  It is intended mainly for use within the Startup-Sequence
and in EXECUTE scripts.


HOW TO USE WICONIFYWINDOW:

To use wIconifyWindow, you must have wIconify running.  To iconify a window,
simply type

    1> wIconifyWindow [window]

where [window] is the name of the window to iconify.  If the window is not
already iconified, and if it is able to be iconified, it will be replaced by
an icon toward the bottom on the wIconify window.  If the window is already
iconified, it will be restored and the icon removed.

You can also specify a screen name if the window is not on the active
screen.  The following example would iconify the AmigaDos window on the
workbench screen:

    1> wIconifyWindow AmigaDos Workbench

If the window or screen name contains a space, enclose it in quotation
marks, as in the example below:

    1> wIconifyWindow "Calc v3.0" "Test Screen"

If you do not give a screen name, the currently active screen is assumed. 
If you do not give a window name, the currently active window is assumed.

To specify the position of the icon, add 'AT x,y' to the commmand, where x
and y are the position (in pixels) from the upper left-hand corner of the
wIconify window where you want the icon to appear.  wIconify will place the
icon as close to this position as possible, without interfering with other
icons.

    1> wIconifyWindow AmigaShell AT 50,100

would iconify the AmigaShell window and place the icon at 50 pixels from the
left of the window and 100 pixels down from the top of the wIconify window.
If you do not specify a position, the first available position will be used.

You must not put a space around the comma when you specify a position.  Thus
'10 ,20' '45, 110' and '55 , 75' are all illegal position, while '300,50' is
acceptable.

You can also supply a number of flags that alter the way wIconify treats the 
window's icon.  These include:

    NOSAVEPOS       Don't save the icons possition after it is openned
    NOMOVE          Don't allow the icon to be dragged from its current position
    NOORGANIZE      ORGANIZE and CLEANUP will not affect this icon
    LOCKED          Don't allow the icon's position to change at all
    NOCLOSE         Don't allow the CLOSE menu or left-right click to close
                    this icon's window
    NOMULTISELECT   Don't allow other icons to be selected together with
                    this one
    CHANGEREFRESH   If the window is SMART_REFRESH change it to SIMPLE_REFRESH
                    whenever it is iconified.  WARNING: this is somewhat 
                    dangerous, and may result in the update status of the
                    screen becoming confused.  See the wIconify documentation
                    for more information.

You can plas a minus sign (-) in front of any of these flags; this will case
the given attribute to be removed from the icon.  For example, -NOMOVE
would remove the NOMOVE attribute, hence the icon would become moveable.

If you supply any of these flags, they will remain in effect until you close
the window, or until you issue another wIconifyWindow command for the given
window that changes the settings of the flags.  The default is to change none
of these flags.


AUTHOR:

Davide P. Cervone
Mathematics Department
Brown University
Providence, Rhode Island 02912
ST402523@BROWNVM