Activatewin.i386-aros

ActivateWin: gives to Shell some Intuition's handling on windows/screens

TITLE/M		Title(s) of window(s) to act on (activate by default).
		Wildcards allowed. This argument is case-dependant!
LIST/S		List windows titles while scanning
ALL/S		List all screens and windows titles while scanning
QUIET/S		Disable (LFORMAT) and any output, even if (TITLE) is not
		found
CURRENT/S	Act on currently active window/screen
DONOTBUT/S	Do not activate found window, but do other things
HIDE/S		Make found window invisible
		When omitted, an invisible found window is made visible
		No other operation will be done on a hidden window!
MX=MOVEX/N/K	Move found window/screen horizontally (pixels)
MY=MOVEY/N/K	Move found window/screen vertically (pixels)
SX=SIZEWINX/N/K	Resize found window horizontally (add/sub pixels)
SY=SIZEWINY/N/K	Resize found window vertically (add/sub pixels)
ALT=ALTCOORDS/S	Let MX and MY mean coordinates relative to origin,
		and (windows only) SX and SY mean real size
TOFRONT/S	Bring found window/screen to front
TOBACK/S	Bring found window/screen to back
ZIP/S		Move and resize found  window to alternate coords
CLOSE/S		Try to close found window (send IDCMP close)
SCREEN=SCREENS/S	
		Act on screen (TITLE): MX, MY, TOFRONT, TOBACK, ALT and
		CURRENT arguments are recognized when using this switch
LFORMAT/K	Specify the format of output printed for the object found
		The following attributes are available:
		%T title of the object
		%W width of the object		%H height of the object
		%X X-coord of left-edge		%Y Y-coord of top-edge
		%F title of the front most window relative to found object
		%N title of the next object of the same class
		%S[T|W|H|X|Y|F|N|B] specified value of object's screen
		%[S]B Screen-bar's height
		%[S]V[W|H|X|Y] specified value of object's screen's ViewPort
		Note that %B and %V only apply to screens objects


LIST ALL is used by default when no argument is given

Return-code will be set to:
	OK     (0) all went well
	WARN   (5) window/screen (TITLE) was not found
	ERROR (10) user interrupted the process (CTRL-C)
	FAIL  (20) intuition.library couldn't be opened, incorrect argument

Those arguments are shown from the Shell by typing:
"ActivateWin ?"
followed by a new "?".


EXAMPLES

    ActivateWin HIDE #?Shell
        will hide all the Shell windows currently opened (just open a new Shell
and type: "ActivateWin #?" to bring them back visible).

    ActivateWin CLOSE CURRENT
        will try to close the currently active window, ie probably the Shell
window in which you just typed the command ;-)

    ActivateWin "AROS-Shell" MX=-15 ALT
        will activate and put the front-most Shell window 15 pixels at the left
of the left-side of the screen.

    ActivateWin SCREEN DOPUS#? MY=150
        will drag down 150 pixels of their current position all screens of all
instances of Directory Opus. The currently active window won't be changed.


HISTORY

        (INT means the release was not made public)

        20.11.2014  41.12 Compiled and released for ABI_V0-on-trunk-20140828 and
ABI_V1
    INT 10.06.2011  41.11 Implemented LFORMAT and ZIP
    INT 26.04.2011  41.10 Reworked LIST behaviour
        21.04.2011  41.9  Implemented wildcards handling in TITLEs
    INT 19.04.2011  41.8  Implemented CURRENT and CLOSE arguments, multiple
                          TITLEs allowed
        07.04.2011  41.7  More arguments
        01.04.2011  41.6  More arguments, less bugs...
        31.03.2011  41.5  Better and simpler way to find the topmost layer,
                          thanks to Thomas Rapp's example code here:
http://utilitybase.com/forum/index.php?action=vthread&forum=3&topic=2240#msg1851
2
    INT       2010  41.4  Some more optional arguments
        16.11.2010  41.3  Added locking for access to Intuition fields, to
                          avoid crashes in race condition... (Many thanks Fab1!)
        07.05.2010  41.2  Set DEBUG off, added LIST and QUIET switches
        03.05.2010  41.1  Implemented


NOTE

I would be very pleased to get feedback from you about ActivateWin, so please
don't hesitate to drop me a mail (olivier dot tigreat at gmail dot com), with
your bug reports, feature requests, or simply to tell me you tried it.