home *** CD-ROM | disk | FTP | other *** search
Text File | 1996-03-18 | 29.0 KB | 1,253 lines |
-
- SwitchWindow alpha version - BOOPSI ENVIRONMENT
-
- * ALPHA VERSION ALPHA VERSION ALPHA VERSION ALPHA VERSION ALPHA VERSION
-
- * This document DOES not reflect the current state of SwitchWindow.
- * This document based on the docs created for SwitchWindow external release
- * 1.1, with few changes.
- * All class docs are up to date, but some contents have been removed
- * (dots ...).
-
- * This is external release 1.2, internal known as 1.52.
-
- Be warned: This version is only for testing, not for standard use.
- Please do not copy this version.
- This version may crash your machine at any time, with unexpected results.
-
- An object-oriented window tool based on the idea of Commodore's
- IHelp && FKey.
- To be used with Kickstart 3.x, written by Roland 'Gizzy' Mainz, freeware,
- all rights reserved.
- No guarantee is made of any kind is made that the programm described below
- in this document is 100% reliable. You use this material on your own risk.
-
-
- =========================== Introduction ==================================
- ===========================================================================
- SwitchWindow is an object-oriented window managing tool with a powerful
- AREXX port.
- You may move, size or zoom any window you have specified via hotkey, mouse
- or REXX, create screens, windows and other GUI elements like gadgets, menus
- or icondropboxes and connect all these objects together.
-
-
- ========================= System Requirements =============================
- ===========================================================================
- SwitchWindow requires an Amiga with at least 1M of memory. AmigaOS 3.0 or
- later is also required.
- SwitchWindow will take round about 200k space including code, default
- objects and dynamic memory.
-
- SwitchWindow is currently only tested on my private Amiga (Amiga 2000C,
- M68030/68882, 1MB Chip, 16MB Fast, 425MB Nexus HD, OS 3.1 //
- Amiga 1200 2MB Chip, 16M Fast, 68030/68882 50MHZ, SCSI 1.2GB, OS 3.0).
-
- There will be also a AmigaOS 2.0 version, but currently I have not enough
- time to invest in it.
-
- ============================= Known BUGS ==================================
- ===========================================================================
- - Requires much memory (allocates large pages of memory for fast execution).
- - Does not work properly at low mem conditions, this affects:
- - Startup Initalisation:
- The stringtag database (stringtagclass) won't hold the whole supported
- tags. May cause deadlocks.
- - String conversion:
- - Results like strings won't appear.
- - String to TagItem (stringtagclass) conversion won't work properly.
- - Requesters (ASL etc.) won't appear (not really a bug).
- - Enforcer hits
- - Deadlocks while using datatypes objects
-
- =========================== Installation ==================================
- ===========================================================================
- 1. Workbench
- Drop the 'SwitchWindow' icon and it's contents in your favorite drawer
- (like "Sys:WBStartup" or "Sys:Tools/Commodities"). If you'd put it into
- SYS:WBStartup be sure that the tooltype "DONOTWAIT=TRUE" is set, otherwise
- the Workbench will stop processing/executing any other icon in this drawer
- until SwitchWindow ends (after a short time the WB will call you with a
- requester).
-
- 2. CLI/Shell
- Drop/Copy the 'SwitchWindow' file in your favorite directory (like
- "SYS:Tools/Commodities").
- If you like to run the program at startup, get your favorite editor and add
- this line to S:user-startup (do NOT modify the S:startup-sequence !):
-
- run <>nil: Sys:Tools/Commodities/SwitchWindow startup=REXX:swstartup.sw
-
- 3. CBM's Installer utility
- Double-click on the Install-SwitchWindow icon.
-
-
- ========================== AREXX Interface ================================
- ===========================================================================
-
- Since SwitchWindow's first release I've changed the whole AREXX Interface.
- In SW's new model, AREXX ports are now represented as objects.
- You can call any object, set or get any of it's attributes and so on.
-
- If you want to send commands from an AREXX script to SW, you must tell
- AREXX how to find SW's REXX port. This is done with the AREXX 'ADDRESS'
- command.
-
- example: ADDRESS 'SW.1'
-
-
-
- ========================= Object Class Reference ==========================
- ===========================================================================
-
- All objects described here are based on the BOOPSI (Basic object-oriented
- programming interface for intuition) and TagItems from utility.library,
- both introduced with AmigaDos V36.
-
-
- AREXX Command Reference
- -----------------------
-
- projectclass related commands
- =============================
-
- switchwindow/PROJECT.cmd
-
- NAME
- PROJECT -- Create or modify a project
-
- FORMAT
- PROJECT [NAME <projectname>] [APPLICATIONNAME <applicationname>]
- [PORTBASENAME <rexxport basename>] [PORTNAME <rexxport name>]
- [PORTPRI <number>] [MOVESTEP <number>] [SIZESTEP <number>]
- [STARTUP <scriptname>] [LOCALE <locale prefs file]
- [GUIDE <amigaguide document>] [PUBSCREEN <public screen name>]
- [NOGUI] [NEW] [DISPOSE] [PROMPT]
-
- TEMPLATE
- NAME/K,APPLICATIONNAME/K,PORTBASENAME/K,PORTNAME/K,PORTPRI/K/N,
- MOVESTEP/K/N,SIZESTEP/K/N,STARTUP/K,LOCALE/K,GUIDE/K,PUBSCREEN/K,NOGUI/S,
- NEW/S,DISPOSE/S,PROMPT/S
-
- FUNCTION
- Create or modify a projectclass object. After creation add a
- rexxportclass object.
-
- RESULT
-
- SEE ALSO
- CLOSE.cmd, QUIT.cmd
-
-
- switchwindow/HELP.cmd
-
- NAME
- HELP -- get help information for an object
-
- FORMAT
- HELP [COMMAND|OBJECT <object>] [CONTINOUS <bool>] [PROMPT]
-
- TEMPLATE
- COMMAND=OBJECT/K,CONTINOUS/K,PROMPT/S
-
- FUNCTION
-
- RESULT
-
-
- switchwindow/CLOSE.cmd
-
- NAME
- CLOSE -- Close current project.
-
- FORMAT
- CLOSE [FORCE]
-
- TEMPLATE
- FORCE/S
-
- FUNCTION
- Do set PROJECTA_DONE with the current project (projectclass object).
-
- RESULT
-
- SEE ALSO
- QUIT.cmd, PROJECT.cmd
-
-
- switchwindow/QUIT.cmd
-
- NAME
- QUIT -- Quit whole application.
-
- FORMAT
- QUIT [FORCE]
-
- TEMPLATE
- FORCE/S
-
- FUNCTION
- Closes all projects and terminate the application.
-
- RESULT
-
- SEE ALSO
- CLOSE.cmd, PROJECT.cmd
-
-
-
- Object Related Commands
- =======================
-
- switchwindow/DISPOSEOBJECT.cmd
-
- NAME
- DISPOSEOBJECT -- Delete an object.
-
- FORMAT
- DISPOSEOBJECT [NAME|OBJECT] <objectname> [CLASS <class>]
-
- TEMPLATE
- NAME=OBJECT/A,CLASS/K
-
- FUNCTION
- Delete the named object. CLASS/K forces that only an object of the
- specified class will be deleted.
-
- RESULT
- ERROR_OBJECT_IN_USE
- ERROR_OBJECT_NOT_FOUND
- ERROR_OBJECT_LINKED
-
-
- switchwindow/SETATTR.cmd
-
- NAME
- SETATTR -- Set an object's attribute.
-
- FORMAT
- SETATTR [NAME|OBJECT] <objectname> [CLASS <class>] [FIELD <tagname>]
- [STEM <taglist>] [VAR <data>]
-
- TEMPLATE
- NAME=OBJECT,CLASS/K,FIELD/K,STEM/K,VAR/K
-
- FUNCTION
- Set an object attributes.
- When FIELD/K is given, only the specified attribute is modified.
- Some attributes requiere more information (STEM/K than VAR/K).
-
- When only STEM/K is given, this is the name of a taglist like this
-
- 'setattr class=gadgetclass object=mybutton stem=STEM'
-
- STEM.0.TI_TAG = "GA_ID",
- STEM.0.TI_DATA = 10;
- STEM.1.TI_TAG = "GA_Text";
- STEM.1.TI_DATA = "Button Text";
- STEM.2.TI_TAG = "TAG_DONE";
- STEM.2.TI_DATA = NULL;
-
- Be carefull. Only a valid taglist should be given, terminated by
- "TAG_DONE" or "TAG_MORE", while STEM.x.TI_DATA is the name of
- another stem var.
- There's currently a limit of 256 tags per list, but this will be
- removed. You may change this limit by STEM.COUNT = 100; witch increase
- the limit up to 100 tags per list.
-
- RESULT
- ERROR_OBJECT_NOT_FOUND
-
- SEE ALSO
- GETATTR.cmd
-
-
- switchwindow/GETATTR.cmd
-
- NAME
- GETATTR -- get an object's attribute
-
- FORMAT
- GETATTR [NAME|OBJECT] <objectname> [CLASS <class>] [FIELD <tagname>]
- [STEM <taglist>] [VAR <storage>]
-
- TEMPLATE
- NAME=OBJECT,CLASS/K,FIELD/K,STEM/K,VAR/K
-
- FUNCTION
- Get an attribute from an object. See upstairs for more information
-
- RESULT
- ERROR_OBJECT_NOT_FOUND
-
- SEE ALSO
- SETATTR.cmd
-
-
- switchwindow/ADDMEMBER.cmd
-
- NAME
- ADDMEMBER -- Add an object to another.
-
- FORMAT
- ADDMEMBER [MASTER] <mastername> [MEMBER] <membername>
- [MASTERCLASS <class>] [MEMBERCLASS <class>] [PROMPT]
-
- TEMPLATE
- MASTER/A,MEMBER,MASTERCLASS/K,MEMBERCLASS/K,PROMPT/S
-
- FUNCTION
-
- SEE ALSO
- REMMEMBER.cmd
-
-
- switchwindow/REMMEMBER.cmd
-
- NAME
- REMMEMBER -- Remove an object from its master.
-
- FORMAT
- REMMEMBER [MASTER] <mastername> [MEMBER] <membername>
- [MASTERCLASS <class>] [MEMBERCLASS <class>] [PROMPT]
-
- TEMPLATE
- MASTER/A,MEMBER,MASTERCLASS/K,MEMBERCLASS/K,PROMPT/S
-
- FUNCTION
-
- SEE ALSO
- ADDMEMBER.cmd
-
-
- switchwindow/DISABLE.cmd
-
- NAME
- DISABLE -- Disable an object.
-
- FORMAT
- DISABLE [NAME|OBJECT] <objectname> [CLASS <class>]
-
- TEMPLATE
- NAME=OBJECT,CLASS/K,PROMPT/S
-
- FUNCTION
- Disables an object of following classes:
-
- gadgetclass datatypesclass
- cxclass cxfilterclass cxtranslateclass brokerclass
- rexxportclass
-
- RESULT
- ERROR_ACTION_NOT_KNOWN
- ERROR_OBJECT_NOT_FOUND
-
- SEE ALSO
- ENABLE.cmd, SETATTR.cmd
-
-
- switchwindow/ENABLE.cmd
-
- NAME
- ENABLE -- Enable an object.
-
- FORMAT
- ENABLE [NAME|OBJECT] <objectname> [CLASS <class>]
-
- TEMPLATE
- NAME=OBJECT,CLASS/K,PROMPT/S
-
- FUNCTION
- Enables an object of following classes:
-
- gadgetclass datatypesclass
- cxclass cxfilterclass cxtranslateclass brokerclass
- rexxportclass
-
- RESULT
- ERROR_ACTION_NOT_KNOWN
- ERROR_OBJECT_NOT_FOUND
-
- SEE ALSO
- DISABLE.cmd, SETATTR.cmd
-
-
- Commodities-Related Commands
- ============================
-
- switchwindow/BROKER.cmd
-
- NAME
- BROKER -- Create or modify a commodities broker object.
-
- FORMAT
- BROKER [NAME|OBJECT] <object> [BROKERA_NAME <brokername>]
- [BROKERA_TITLE <title>] [BROKERA_DESCR|BROKERA_DESCRIPTION <description>]
- [CXA_PRIORITY <number>] [CX_DISABLED <bool>] [BROKERA_DOUNIQUE <bool>]
- [BROKERA_DOSHOWHIDE <bool>] [ICA_TARGET <target>] [NEW] [PROMPT]
-
- TEMPLATE
- NAME=OBJECT,BROKERA_NAME/K,BROKERA_TITLE/K,
- BROKERA_DESCR=BROKERA_DESCRIPTION/K,CXA_PRIORITY/K/N,
- CXA_DISABLED/K,BROKERA_DOUNIQUE/K,BROKERA_DOSHOWHIDE/K,
- ADDMEMBER/K,REMMEMBER/K,ICA_TARGET/K,NEW/S,PROMPT/S
-
- FUNCTION
- Creates or modify a brokerclass object.
-
- BROKERA_NAME/K is the cx name in the commodities broker list.
-
- BROKERA_DESCR/K is the cx description in the commodities broker list.
-
- BROKERA_TITLE/K is the cx title in the commodities broker list.
-
- CXA_PRIORITY/K/N priority in the commodities broker list.
-
- CXA_DISABLED/K Object should be disabled (args are TRUE or FALSE).
-
- BROKERA_DOUNIQUE/K Determine if broker's cx_name should be unique in
- cx brojerlist or not (args are TRUE or FALSE).
-
- BROKERA_DOSHOWHIDE/K Determine if broker should send BROKERA_SHOWGUI tags or not
- (args are TRUE or FALSE).
-
- ADDMEMBER/K add this object into object's memberlist
- (attach this object (cxclass) to this broker)
-
- REMMEMBER/K remove this object from object's memberlist
- (attach this object (cxclass) to this broker)
-
- ICA_TARGET/K target object (see icclass)
-
-
- switchwindow/HOTKEY.cmd
-
- NAME
- HOTKEY -- Create or modify a commodities hotkey object.
-
- FORMAT
- HOTKEY [NAME|OBJECT] <objectname> [FILTER|KEY <cxfilterstring>]
- [REPLACE <cxreplacestring>] [BROKER|MASTER <masterobject>]
- [CMD|ICA_TARGET|TARGET <objectname>] [NEW] [PROMPT]
-
- TEMPLATE
- NAME=OBJECT,FILTER=KEY/K,REPLACE/K,BROKER=MASTER/K,
- CMD=ICA_TARGET=TARGET/K,NEW/S,PROMPT/S
-
- FUNCTION
- Create a cxfilterclass and a connected cxtranslateclass object for
- filtering or replacing an input action.
-
- FILTER/K should be a valid commodities filter string description.
- RELACE/K should be a valid commodities replace string description.
-
- Both cxfilterclass and cxtranslateclass object get the same name.
- If you want to access them seperately, use the CLASS/K key in those
- commands (CLASS="cxfilterclass" / CLASS="cxtranslateclass").
-
- SEE ALSO
- CXFILTER.cmd, CXTRANSLATE.cmd, BROKER.cmd
-
-
- switchwindow/CXFILTER.cmd
-
- NAME
- CXFILTER -- Create or modify a cxfilterclass object.
-
- FORMAT
- CXFILTER [NAME|OBJECT] <objectname> [FILTER|KEY <cxfilterstring>]
- [BROKER|MASTER <masterobject>] [CMD|ICA_TARGET|TARGET <objectname>]
- [NEW] [PROMPT]
-
- TEMPLATE
- NAME=OBJECT,FILTER=KEY/K,BROKER=MASTER/K,
- CMD=ICA_TARGET=TARGET/K,NEW/S,PROMPT/S
-
- FUNCTION
- Create a cxfilterclass object for filtering an input action.
-
- FILTER/K should be a valid commodities filter string description.
-
- SEE ALSO
- HOTKEY.cmd, CXTRANSLATE.cmd, BROKER.cmd
-
-
- switchwindow/CXTRANSLATE.cmd
-
- NAME
- CXTRANSLATE -- Create or modify a cxtranslateclass object.
-
- FORMAT
- CXTRANSLATE [NAME|OBJECT] <objectname> [REPLACE <cxreplacestring>]
- [MASTER <masterobject>] [NEW] [PROMPT]
-
- TEMPLATE
- NAME=OBJECT,REPLACE/K,MASTER/K,NEW/S,PROMPT/S
-
- FUNCTION
- Create a cxtranslateclass object for replacing an input action.
-
- REPLACE/K should be a valid commodities filter string description.
-
- SEE ALSO
- HOTKEY.cmd, CXFILTER.cmd, BROKER.cmd
-
-
- REXX-Related Commands
- =====================
-
- switchwindow/REXXPORT.cmd
-
- NAME
- REXXPORT -- Create or modify a public rexxport (rexxportclass object).
-
- FORMAT
- REXXPORT [NAME|OBJECT] <objectname> [PORTNAME] <portname>
- [PORTPRI <value>] [NEW] [PROMPT]
-
- TEMPLATE
- NAME=OBJECT,PORTNAME/K,PORTPRI/K/N,NEW/S,PROMPT/S
-
- FUNCTION
- Create or modify a rexxportclass object.
-
- PORTNAME/K object's name which appears in public port list
- PORTPRI/K/N object's priority in public port list
-
- You may change public port name and/or public port list priority
- at runtime. All queuing msgs will be preserved.
-
- SEE ALSO
- LEARN.cmd
-
-
- switchwindow/LEARN.cmd
-
- NAME
- LEARN -- Start/stop or modify logging all actions by a REXXPORT object.
-
- FORMAT
- LEARN [FILE <filename>] [START] [STOP] [PORTNAME <portname>]
- [NAME|OBJECT <portobject>]
-
- TEMPLATE
- FILE/K,START/S,STOP/S,TIMESTAMP/S,NOHEADER/S,NORESULTS/S,PORTNAME/K,
- NAME=OBJECT/K
-
- FUNCTION
- Log all actions at this port.
- There may be more than one log active.
-
- FILE/K Filename of the log. (Defaults to con://///auto/wait/close/inactive)
- START/S start logging
- STOP/S stops logging
- PORTNAME/K name of the public port name
- NAME=OBJECT/K object name
-
- SEE ALSO
- REXXPORT.cmd
-
- BUGS
- Currently 'LEARN STOP' will stop learning/logging the first job started.
- Will be fixed.
-
-
- Gadget-Related Commands
- =======================
-
- switchwindow/BUTTON.cmd
-
- NAME
- BUTTON -- Create or modify a button gadget.
-
- TEMPLATE
- NAME=OBJECT,WINDOW/K,LEFT/K/N,TOP/K/N,WIDTH/K/N,HEIGHT/K/N,TEXT/K,
- IMAGE/K,ENDREQUESTER=GA_ENDGADGET/S,GA_TOGGLESELECT/S,GA_SELECTED/S,
- CMD=ICA_TARGET/K,NEW/S,PROMPT/S
-
- FUNCTION
-
-
- switchwindow/PROPGADGET.cmd
-
- NAME
- PROPGADGET -- Create or modify a proportiornal slider.
-
- TEMPLATE
- NAME=OBJECT,WINDOW/K,LEFT/K/N,TOP/K/N,WIDTH/K/N,HEIGHT/K/N,PGA_TOP/K/N,
- PGA_VISIBLE/K/N,PGA_TOTAL/K/N,PGA_FREEDOM/K,CMD=ICA_TARGET/K,
- NEW/S,PROMPT/S
-
- FUNCTION
-
-
- switchwindow/STRINGGADGET.cmd
-
- NAME
- STRINGGADGET -- Create or modify a string entry field.
-
- TEMPLATE
- NAME=OBJECT,WINDOW/K,LEFT/K/N,TOP/K/N,WIDTH/K/N,HEIGHT/K/N,
- STRING=STRINGA_TEXTVAL/K,VALUE=STRINGA_LONGVAL/K/N,STRINGA_MAXCHARS/K/N,
- CMD=ICA_TARGET/K,NEW/S,PROMPT/S
-
- FUNCTION
-
-
- switchwindow/TEXTGADGET.cmd
-
- NAME
- TEXTGADGET -- Create or modify a string display field
-
- TEMPLATE
- NAME=OBJECT,WINDOW/K,LEFT/K/N,TOP/K/N,WIDTH/K/N,HEIGHT/K/N,
- STRING=STRINGA_TEXTVAL/K,VALUE=STRINGA_LONGVAL/K/N,NEW/S,PROMPT/S
-
- FUNCTION
-
-
- Datatypes-Related Commands
- ==========================
-
- switchwindow/DATATYPES.cmd
-
- NAME
- DATATYPES -- Create or modify a datatypes object.
-
- TEMPLATE
- NAME=OBJECT,WINDOW/K,LEFT/K/N,TOP/K/N,WIDTH/K/N,HEIGHT/K/N,
- FILE=FILENAME/K,CLIPBOARD/S,CLIPUNIT/K/N,FONTNAME/K,FONTSIZE/K/N,
- STEM/K,CMD=ICA_TARGET/K,NEW/S,PROMPT/S
-
- FUNCTION
-
-
- ICClass Commands
- ================
-
- switchwindow/INTERCONNECTION.cmd
-
- NAME
- INTERCONNECTION -- Create or modify an icclass object.
-
- TEMPLATE
- NAME=OBJECT,CMD=ICA_TARGET/K,ICA_MAP=MAPSTEM/K,NEW/S,PROMPT/S
-
- FUNCTION
-
-
- switchwindow/MODEL.cmd
-
- NAME
- MODEL -- Create or modify a modelclass object.
-
- TEMPLATE
- NAME=OBJECT,CMD=ICA_TARGET/K,ICA_MAP=MAPSTEM/K,ADDMEMBER/K,REMMEMBER/K,
- NEW/S,PROMPT/S
-
- FUNCTION
-
-
- switchwindow/GETATTRSCONNECTION.cmd
-
- NAME
- GETATTRSCONNECTION -- Create or modify a getattrsclass object.
-
- TEMPLATE
- NAME=OBJECT,CMD=ICA_TARGET/K,ICA_MAP=MAPSTEM/K,GETATTRSA_SOURCEOBJECT/K,
- GETATTRSA_GETATTRTAGLIST/K,NEW/S,PROMPT/S
-
- FUNCTION
-
-
- Image related commands
- ======================
-
- switchwindow/FRAMEICLASS.cmd
-
- NAME
- FRAMEICLASS -- Create or modify a frame image.
-
- TEMPLATE
- NAME=OBJECT,LEFT/K/N,TOP/K/N,WIDTH/K/N,HEIGHT/K/N,IA_FRAMETYPE/K,
- NEW/S,PROMPT/S
-
- FUNCTION
-
-
- requesterclass related commands
- ===============================
-
- switchwindow/REQUESTER.cmd
-
- NAME
- REQUESTER -- Create or modify a Intuition requester.
-
- TEMPLATE
- NAME=OBJECT,WINDOW/K,LEFT=RELLEFT/K/N,TOP=RELTOP/K/N,WIDTH/K/N,
- HEIGHT/K/N,IMAGE/K,TITLE/K,DMREQUEST/S,POINTREL/S,REQUEST=SETDMREQUEST/S,
- ENDREQUEST=CLEARDMREQUEST/S,NEW/S,PROMPT/S
-
- FUNCTION
-
-
- windowclass related commands
- ============================
-
- switchwindow/WINDOW.cmd
-
- NAME
- WINDOW -- Create or modify a window.
-
- TEMPLATE
- NAME=OBJECT,OPEN/S,CLOSE/S,SNAPSHOT/S,ACTIVATE/S,MIN/S,MAX/S,FRONT/S,
- BACK/S,LEFTEDGE/K/N,TOPEDGE/K/N,WIDTH/K/N,HEIGHT/K/N,SIZEGADGET/K,
- CLOSEGADGET/K,PUBSCREEN/K,TITLE/K,SCREENTITLE/K,WA_IDCMP/K,ICA_TARGET/K,
- STEM/K,NEW/S,PROMPT/S
-
- FUNCTION
-
-
- Window-Related Commands
- =======================
-
- switchwindow/MOVEWINDOW.cmd
-
- NAME
- MOVEWINDOW -- Move a window to the specified coordinates.
-
- FORMAT
- MOVEWINDOW [LEFTEDGE <number>] [TOPEDGE <number>] [WINDOW <pattern>]
- [PUBSCREEN <pubscreenname>]
-
- TEMPLATE
- LEFTEDGE/K/N,TOPEDGE/K/N,WINDOW/K,PUBSCREEN/K
-
- FUNCTION
-
- "MOVEUPWINDOW"
- "MOVEDOWNWINDOW"
- "MOVELEFTWINDOW"
- "MOVERIGHTWINDOW"
-
- "MOVEPAGEUPWINDOW"
- "MOVEPAGEDOWNWINDOW"
- "MOVEPAGELEFTWINDOW"
- "MOVEPAGERIGHTWINDOW"
-
-
- switchwindow/SIZEWINDOW.cmd
-
- NAME
- SIZEWINDOW -- Change the window's box.
-
- FORMAT
- SIZEWINDOW [WIDTH <number>] [HEIGHT <number>] [WINDOW <pattern>]
- [PUBSCREEN <pubscreenname>]
-
- TEMPLATE
- WIDTH/K/N,HEIGHT/K/N,WINDOW/K,PUBSCREEN/K
-
- FUNCTION
-
- SIZEUPWINDOW
- SIZEDOWNWINDOW
- SIZELEFTWINDOW
- SIZERIGHTWINDOW
-
- SIZEPAGEUPWINDOW
- SIZEPAGEDOWNWINDOW
- SIZEPAGELEFTWINDOW
- SIZEPAGERIGHTWINDOW
-
- SEE ALSO
- intuition.library/SizeWindow()
-
-
- switchwindow/CHANGEWINDOW.cmd
-
- NAME
- CHANGEWINDOW -- Change a window's box in position and dimensions.
-
- FORMAT
- CHANGEWINDOW [LEFTEDGE <number>] [TOPEDGE <number>] [WIDTH <number>]
- [HEIGHT <number>] [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
-
- TEMPLATE
- LEFTEDGE/K/N,TOPEDGE/K/N,WIDTH/K/N,HEIGHT/K/N,WINDOW/K,PUBSCREEN/K
-
- FUNCTION
-
-
- switchwindow/WINDOWTOFRONT.cmd
-
- NAME
- WINDOWTOFRONT -- Bring a window to the front.
-
- FORMAT
- WINDOWTOFRONT [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
-
- TEMPLATE
- WINDOW/K,PUBSCREEN/K
-
- FUNCTION
-
- SEE ALSO
- WINDOWTOBACK.cmd, intuition.library/WindowToFront()
-
-
- switchwindow/WINDOWTOBACK.cmd
-
- NAME
- WINDOWTOBACK -- Send a window behind all others.
-
- FORMAT
- WINDOWTOBACK [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
-
- TEMPLATE
- WINDOW/K,PUBSCREEN/K
-
- FUNCTION
-
- SEE ALSO
- WINDOWTOFRONT.cmd, intuition.library/WindowToBack()
-
-
- switchwindow/WINDOWINFRONTOF.cmd
-
- NAME
- WINDOWINFRONTOF -- Future usage.
-
- FORMAT
- WINDOWINFRONTOF [WINDOW] <pattern> [BEHINDWINDOW] <pattern>
- [PUBSCREEN <publicscreenname>]
-
- TEMPLATE
- WINDOW/A,BEHINDWINDOW/A,PUBSCREEN/K
-
- FUNCTION
-
- SEE ALSO
- WINDOWTOFRONT.cmd, WINDOWTOBACK.cmd,
- intuition.library/MoveWindowInFrontOf()
-
-
- switchwindow/WINDOWTOMOUSE.cmd
-
- NAME
- WINDOWTOMOUSE
-
- FORMAT
- WINDOWTOMOUSE [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
-
- TEMPLATE
- WINDOW/K,PUBSCREEN/K
-
- FUNCTION
-
-
- switchwindow/MOUSETOWINDOW.cmd
-
- NAME
- MOUSETOWINDOW -- Move the mousepointer to a windows left top edge.
-
- FORMAT
- MOUSETOWINDOW [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
-
- TEMPLATE
- WINDOW/K,PUBSCREEN/K
-
- FUNCTION
-
- BUGS
- Not fully implemented yet.
-
-
- switchwindow/WINDOWTOSCREENCLIP.cmd
-
- NAME
- WINDOWTOSCREENCLIP -- Move a window into the current visible clip of the
- screen.
-
- FORMAT
- WINDOWTOSCREENCLIP [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
-
- TEMPLATE
- WINDOW/K,PUBSCREEN/K
-
- FUNCTION
-
-
- switchwindow/SCREENCLIPTOWINDOW.cmd
-
- NAME
- SCREENCLIPTOWINDOW -- Make the specified window visible.
-
- FORMAT
- SCREENCLIPTOWINDOW [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
-
- TEMPLATE
- WINDOW/K,PUBSCREEN/K
-
- FUNCTION
-
- SEE ALSO
- ScreenPosition( SPOS_MAKEVISIBLE, ... )
-
-
- switchwindow/ACTIVATEWINDOW.cmd
-
- NAME
- ACTIVATEWINDOW -- Make a window active and useable.
-
- FORMAT
- ACTIVATEWINDOW [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
-
- TEMPLATE
- WINDOW/K,PUBSCREEN/K
-
- FUNCTION
- Brings the specified window to front, unzoomes and activates it.
-
- SEE ALSO
- intuition.library/ActivateWindow()
-
-
- switchwindow/ZOOMWINDOW.cmd
-
- NAME
- ZOOMWINDOW -- Zooms a window between two fixed sizes.
-
- FORMAT
- ZOOMWINDOW [WINDOW <pattern>] [PUBSCREEN <pubscreenname>] [TOGGLE]
-
- TEMPLATE
- WINDOW/K,PUBSCREEN/K,TOGGLE/S
-
- FUNCTION
-
- SEE ALSO
- intuition.library/ZipWindow()
-
-
- switchwindow/UNZOOMWINDOW.cmd
-
- NAME
- UNZOOMWINDOW -- Unzoom a window.
-
- FORMAT
- UNZOOMWINDOW [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
-
- TEMPLATE
- WINDOW/K,PUBSCREEN/K
-
- FUNCTION
-
-
- Programmable Requesters
- =======================
-
- switchwindow/REQUESTFILE.cmd
-
- NAME
- REQUESTFILE -- Create an ASL file requester.
-
- FORMAT
- REQUESTFILE [DRAWER|PATH <path>] [FILE <filename>] [PATTERN <string>]
- [TITLE <string>] [POSITIVE <string>] [NEGATIVE <string>]
- [ACCEPTPATTERN <pattern>] [REJECTPATTERN <pattern>] [SAVEMODE|MULTISELECT]
- [DRAWERSONLY] [NOICONS] [LEFTEDGE <number>] [TOPEDGE <number>]
- [WIDTH <number>] [HEIGHT <number>] [PUBSCREEN <pubscreenname>]
- [STEM <storage>]
-
- TEMPLATE
- DRAWER=PATH/K,FILE/K,PATTERN/K,TITLE/K,POSITIVE/K,NEGATIVE/K,
- ACCEPTPATTERN/K,REJECTPATTERN/K,DOSAVEMODE=SAVEMODE/S,
- DOMULTISELECT=MULTISELECT/S,DRAWERSONLY/K,REJECTICONS=NOICONS/S,
- LEFTEDGE/K/N,TOPEDGE/K/N,WIDTH/K/N,HEIGHT/K/N,PUBSCREEN/K,STEM/K
-
- FUNCTION
-
- SEE ALSO
- asl.library/AslRequest()
-
-
- switchwindow/REQUESTFONT.cmd
-
- NAME
- REQUESTFONT -- Create an ASL font requester.
-
- FORMAT
- REQUESTFONT [FONTNAME|FONT <fontname>] [FONTSIZE|SIZE <fontsize>]
- [TITLE <string>] [POSITIVE <string>] [NEGATIVE <string>]
- [MINFONTHEIGHT <value>] [MAXFONTHEIGHT <value>] [ONLYFIXEDWIDTH]
- [FRONTPEN <number>] [BACKPEN <number>] [ITALIC] [BOLD] [PLAIN]
- [UNDERLINED] [REQUESTFRONTCOLOR] [REQUESTBACKCOLOR] [REQUESTDRAWMODE]
- [REQUESTSTYLES] [DRAWMODESTEM <storage>] [LEFTEDGE <value>]
- [TOPEDGE <value>] [WIDTH <value>] [HEIGHT <value>]
- [PUBSCREEN <pubscreename>]
-
- TEMPLATE
- FONTNAME=FONT/K,FONTSIZE=SIZE/K/N,TITLE/K,POSITIVE/K,NEGATIVE/K,
- MINFONTHEIGHT/K/N,MAXFONTHEIGHT/K/N,ONLYFIXEDWIDTH/S,FRONTPEN/K/N,
- BACKPEN/K/N,MAXFRONTPEN/K/N,MAXBACKPEN/K/N,ITALIC/S,BOLD/S,PLAIN/S,
- UNDERLINED/S,DOFRONTPEN=REQUESTFRONTCOLOR/S,DOBACKPEN=REQUESTBACKCOLOR/S,
- DODRAWMODE=REQUESTDRAWMODE/S,DOSTYLE=REQUESTSTYLES/S,DRAWMODESTEM/K,
- DRAWMODE/K/N,LEFTEDGE/K/N,TOPEDGE/K/N,WIDTH/K/N,HEIGHT/K/N,
- PUBSCREEN/K,STEM/K
-
- FUNCTION
-
- SEE ALSO
- asl.library/AslRequest()
-
-
- switchwindow/REQUESTSCREENMODE.cmd
-
- NAME
- REQUESTSCREENMODE -- Create an ASL screenmode requester.
-
- TEMPLATE
- TITLE/K,POSITIVE/K,NEGATIVE/K,LEFTEDGE/K/N,TOPEDGE/K/N,WIDTH/K/N,
- HEIGHT/K/N,PUBSCREEN/K,INFO/S,INFOLEFTEDGE/K/N,INFOTOPEDGE/K/N,
- DISPLAYID/K/N,SCREENWIDTH/K/N,SCREENHEIGHT/K/N,SCREENDEPTH/K/N,
- AUTOSCROLL/S,OVERSCANTYPE/K,DOWIDTH=REQUESTWIDTH/S,
- DOHEIGHT=REQUESTHEIGHT/S,DODEPTH=REQUESTDEPTH/S,
- DOOVERSCANTYPE=REQUESTOVERSCANTYPE/S,DOAUTOSCROLL=REQUESTAUTOSCROLL/S,
- MINSCREENWIDTH/K/N,MAXSCREENWIDTH/K/N,MINSCREENHEIGHT/K/N,
- MAXSCREENHEIGHT/K/N,MINSCREENDEPTH/K/N,MAXSCREENDEPTH/K/N
-
- FUNCTION
-
- SEE ALSO
- asl.library/AslRequest()
-
-
- switchwindow/REQUESTPUBSCREEN.cmd
-
- NAME
- REQUESTPUBSCREEN -- future
-
- FORMAT
- REQUESTPUBSCREEN [TITLE <string>] [DEFAULT <string>] [LEFTEDGE <value>]
- [TOPEDGE <value>] [WIDTH <value>] [HEIGHT <value>]
- [PUBSCREEN <pubscreenname>] [FONTNAME|FONT <fontname>]
- [FONTSIZE|SIZE <fontsize>]
-
-
- TEMPLATE
- TITLE/K,DEFAULT/K,LEFTEDGE/K/N,TOPEDGE/K/N,WIDTH/K/N,HEIGHT/K/N,
- FONTNAME=FONT/K,FONTSIZE=SIZE/K/N,PUBSCREEN/K
-
- FUNCTION
-
- BUGS
- Not implemented yet.
-
-
- switchwindow/REQUESTSTRING.cmd
-
- NAME
- REQUESTSTRING -- future
-
- FORMAT
- REQUESTSTRING [TITLE <string>] [PROMPT|TEXT <text>]
- [DEFAULT|STRING <string>] [LEFTEDGE <value>] [WIDTH <value>]
- [HEIGHT <value>] [TOPEDGE <value>] [PUBSCREEN <pubscreenname>]
- [FONTNAME|FONT <fontname>] [FONTSIZE|SIZE <fontsize>]
-
- TEMPLATE
- TITLE/K,PROMPT=TEXT/K,DEFAULT=STRING/K,LEFTEDGE/K/N,TOPEDGE/K/N,
- WIDTH/K/N,HEIGHT/K/N,PUBSCREEN/K,FONTNAME=FONT/K,FONTSIZE=SIZE/K/N
-
- FUNCTION
-
- BUGS
- Not implemented yet.
-
-
- switchwindow/REQUESTNUMBER.cmd
-
- NAME
- REQUESTNUMBER -- future
-
- FORMAT
- REQUESTNUMBER [TITLE <string>] [PROMPT|TEXT <string>]
- [DEFAULT|NUMBER <value>] [MIN <value>] [MAX <value>]
- [LEFTEDGE <value>] [TOPEDGE <value>] [WIDTH <value>] [HEIGHT <value>]
- [PUBSCREEN <pubscreenname>] [FONTNAME|FONT <fontname>]
- [FONTSIZE|SIZE <value>]
-
- TEMPLATE
- TITLE/K,PROMPT=TEXT/K,DEFAULT=NUMBER/K/N,MIN/K/N,MAX/K/N,LEFTEDGE/K/N,
- TOPEDGE/K/N,WIDTH/K/N,HEIGHT/K/N,PUBSCREEN/K,FONTNAME=FONT/K,
- FONTSIZE=SIZE/K/N
-
- FUNCTION
-
- BUGS
- Not implemented yet.
-
-
- switchwindow/REQUESTCHOICE.cmd
-
- NAME
- REQUESTCHOICE
-
- FORMAT
- REQUESTCHOICE [TITLE <string>] [TEXT <string>] [SYMBOLS <string>]
- [PUBSCREEN <pubscreenname>]
-
- TEMPLATE
- TITLE/K,TEXT/K,SYMBOLS/K,PUBSCREEN/K
-
- FUNCTION
-
- BUGS
- Did not respect PUBSCREEN/K yet.
-
-
- switchwindow/REQUESTRESPONSE.cmd
-
- NAME
- REQUESTRESPONSE
-
- FORMAT
- REQUESTRESPONSE [TITLE <string>] [TEXT <string>] [POSITIVE <string>]
- [NEGATIVE <string>] [PUBSCREEN <pubscreenname>]
-
- TEMPLATE
- TITLE/K,TEXT/K,POSITIVE/K,NEGATIVE/K,PUBSCREEN/K
-
- FUNCTION
-
- BUGS
- Did not respect PUBSCREEN/K yet.
-
-
- switchwindow/REQUESTNOTIFY.cmd
-
- NAME
- REQUESTNOTIFY
-
- FORMAT
- REQUESTNOTIFY [TITLE <string>] [TEXT <string>] [PROCEED <string>]
- [PUBSCREEN <pubscreenname>]
-
- TEMPLATE
- TITLE/K,TEXT/K,PROCEED/K,PUBSCREEN/K
-
- FUNCTION
-
- BUGS
- Did not respect PUBSCREEN/K yet.
-
-
- Execution related commands
- --------------------------
-
- switchwindow/SHELLEXEC.cmd
-
- NAME
- SHELLEXEC
-
- TEMPLATE
- NAME=OBJECT,STRING/K,INPUTFILE/K,OUTPUTFILE/K,ERRORFILE/K,ASYNCH/S,USERSHELL/S,
- CUSTOMSHELL/K,STACK/K/N,PRIORITY=PRI/K/N,NEW/S,PROMPT/S
-
- FUNCTION
-
- switchwindow/WBEXEC.cmd
-
- NAME
- WBEXEC -- execute a programm/project like from workbench
-
- TEMPLATE
- NAME=OBJECT,ICONNAME/K,PRIORITY=NP_PRIORITY/K/N,STACKSIZE=NP_STACKSIZE/K/N,
- NEW/S,PROMPT/S
-
- FUNCTION
-
-
- Miscellaneous Commands
- ======================
-
- switchwindow/BEEPSCREEN.cmd
-
- NAME
- BEEPSCREEN
-
- FORMAT
- BEEPSCREEN [PUBSCREEN <pubscreenname>]
-
- TEMPLATE
- PUBSCREEN/K
-
- FUNCTION
-
-
- switchwindow/NOP.cmd
-
- NAME
- NOP
-
- FORMAT
- NOP
-
- TEMPLATE
- ,
-
- FUNCTION
-
- =============================== TODO ======================================
- ===========================================================================
- This is an alpha version.
- Anything will change, anything will move.
- Be aware.
-
- ============================== SOURCE =====================================
- ===========================================================================
- This is an alpha version.
- Source is under construction.
- Source is available by the author (restricted).
- Source will be included in the external 2.0 version (freeware ??).
-
- *** There MUST NOT exist a pre-2.0 version with source in the public.
- *** If there is one, send me a mail. Illegal owners will be eaten. :-)
-
- *** This also applies to mpeg.datatype (a mpeg system stream player
- *** datatype, which is currently under construction).
-
- =========================== Author's Request ==============================
- ===========================================================================
- By releasing this program I do not place any obligations on you,
- feel free to share this program with your friends (and enemies).
-
- If you want to blame me, report any bugs, or wants a new version
- send your letter to:
- Roland Mainz
- Hohenstaufenstraße 8
- 52388 Nörvenich
- GERMANY
-
- EMAIL is also available:
- If you don't find a file "email.changed" in this archieve,
- my email address is:
- mainz@mats.gmd.de
-
- Sorry, but I can only look once a month for mails.
-
- The entire "SwitchWindow" package may be noncommercially redistributed,
- provided that the package is always distributed in it's complete form
- (including it's documentation). A small copy fee for media costs is okay
- but any kind of commercial distribution is strictly forbidden!
- Comments and suggestions how to improve this program are generally
- appreciated!
-
- Thanks to Matt Dillon for his DICE, and Olaf 'Olsen' Barthel for his
- help, ideas and some text clips from his documentations.
-
-
-
-
-