home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / commodity / windowtiler / windowtiler.doc < prev    next >
Text File  |  1995-02-27  |  8KB  |  209 lines
  1.    WindowTiler 2.1 -  6/17/92  by Doug Dyer
  2.    The Complete Funola for the whole family!
  3.  
  4.   
  5. ---------------------------
  6. What's New?
  7.  
  8. I have addressed almost all known problems and finally added virtual
  9. screen support.  Everything is now "solidified" and I can spend more
  10. time playing with a cute GUI for it.
  11.  
  12. New tooltypes are:  VISIBLE, VISIBLETOGGLE.
  13.  
  14. In general, everything works better and safer than v2.0.  Then only
  15. known bug that irks me is the fact that you can "zipwindow" the 
  16. workbench screen as if it is a window.  I've tried comparing this
  17. and that flags for both the wbench screen and window, but no luck
  18. (I can stop the problem if I treat the wbench window AND screen as
  19. being illegal for zipping).
  20.  
  21. Fixed double-clicking problems (see the history table at the end of
  22. this file for details).
  23.  
  24. ---------------------------
  25. What is this thing?
  26.  
  27. WindowTiler is a simple commodity for os2.X users that allows you 
  28. to map certain Windows3.X/TurboC++ type window management to a key 
  29. combination. NOTE: if it does nothing try (using commodities exchange)  
  30. disabling any commodities that conflict for the same hotkeys. Although 
  31. it takes some getting used to, tiling the windows and zooming one up to 
  32. work & placing it back is a great way to handle large project.  
  33.  
  34. ---------------------------
  35. Instructions:
  36.  
  37. Select the WindowTiler icon, and then "information" in the workbench 
  38. menu. Then, in the list box add or edit the tools listed to conform to 
  39. keyboard equivalents you want.  For instance, to set CASCADE to alt-f10, 
  40. just type (with no extra spaces, and CAPITALIZATION MATTERS) 
  41. CASCADE=Alt F10.
  42.  
  43.  
  44. Keyboard Equivalents (well, not very documented..):
  45.  
  46.    Alt       (any alt key)
  47.    RAlt
  48.    LAlt
  49.    Shift     (any shift key)
  50.    RShift
  51.    LShift
  52.    RCommand
  53.    LCommand
  54.    Control
  55.    Numericpad
  56.    Rbutton   (mouse buttons)
  57.    Lbutton
  58.    A,B,...
  59.  
  60.  
  61. ----------------------------
  62. CUSTOM Tool types available: 
  63.  
  64.   CASCADE       Cascades all resizeable windows.
  65.  
  66.   CASCADELEFT   Cascades windows with right sides inset.   
  67.                 This one also leaves a bit of space on the right 
  68.                 side of the screen (I use that to get to my dock 
  69.                 window). This one is also easier to use since it 
  70.                 gives you access to the front/back gadgets.    
  71.  
  72.   TILE          Tiles windows 
  73.  
  74.   VTILE         Lists windows vertically
  75.  
  76.   HTILE         Lists windows horizontally
  77.  
  78.   MINIMIZE      Shrinks windows
  79.  
  80.   MAXIMIZE      Enlarges windows
  81.  
  82.   REFUSEWINDOW  Use cli arguments to omit windows from windowtiler
  83.                 such as REFUSE=~(#?shell#?) would let windowtiler 
  84.                 only affect windows with a title with "shell" in it.  
  85.                 Use this for windows such as "Clock", and others 
  86.                 that you wish refused. For example, 
  87.                 REFUSEWINDOW=(Workbench|Clock|#?shell) would not move
  88.                 the workbench, clock windows or any window ending in 
  89.                 "shell".
  90.  
  91.   DCLICK        This is a double-click feature with three options:
  92.    
  93.                 "EXPLODE" explodes the window up to front.  Pressing 
  94.                           the zoom gadget places it back where it came 
  95.                           from (ie: tile position). Activated by 
  96.                           double-clicking on window TITLE BAR.
  97.                        
  98.                 "TOFRONT" brings window to front. (click anywhere)
  99.                
  100.                 "BOTH"    Clicking on the title bar performs a ZOOM 
  101.                           and anywhere else, a FRONT.
  102.                        
  103.                 "NONE"    anything else will disable this feature.
  104.  
  105.                 NOTE: clicking on the zoom gadget in the window will 
  106.                 place it back into its tiled or cascaded place.
  107.  
  108.   EXPLODE       Same as DCLICK's EXPLODE, but allows for a keyboard 
  109.                 equivalent.
  110.                 
  111.   ZOOMTOGGLE    Same as pressing the window ZOOM gadget.
  112.  
  113.   TOFRONT       Same as DCLICK's TOFRONT, but allows for a keyboard 
  114.                 equivalent.
  115.  
  116.   TOBACK        Keyboard equivalent for sending a window to the very
  117.                 back.
  118.                 
  119.   REFUSESCREEN  Another DOS pattern string, this one allows 
  120.                 windowtiler to decide whether it should do anything for 
  121.                 a given screen.  For instance, to have it do nothing 
  122.                 when you are using prowrite, you might try 
  123.                 REFUSESCREEN=ProW#?
  124.  
  125.   NOHEIGHT      For high resolution screens, it is annoying for cascading 
  126.                 to give huge windows.  This tooltype will let windowtiler 
  127.                 only change the height of the window when needed (TRUE or 
  128.                 FALSE)
  129.  
  130.   NOWIDTH       Same as NOHEIGHT except for window width (TRUE or FALSE)
  131.  
  132.   SHOWTITLE     All arranged windows will display the screen title when 
  133.                 this is TRUE (even zooming windows).
  134.  
  135.   STEPDOWN      Now you can control the distance windows are "stepped" 
  136.                 for cascading.  This is for the downward step.
  137.  
  138.   STEPLEFT      Same as above except stepping left.
  139.  
  140.   CASCADEHEIGHT Fix the height of windows when they are cascaded.
  141.                 NOHEIGHT overrides this.  
  142.    
  143.   CASCADEWIDTH  Fix the width of windows when they are cascaded. NOWIDTH
  144.                 overrides this.
  145.  
  146.   VISIBLE       This is for VIRTUAL screens.  If VISIBLE is set to TRUE or
  147.                 YES, all arranged screens do so within the current visible
  148.                 screen area.  Otherwise, the virtual screen is used.
  149.                 
  150.   VISIBLETOGGLE This is for VIRTUAL screens.  You can toggle the default
  151.                 option you selected with VISIBLE with a keyboard equivalent.
  152.                                 
  153. ----------------------------
  154. Furthermore...
  155.  
  156. If you place this tool in your wbstartup drawer, don't forget the 
  157. DONOTWAIT (it should already be there).  I find the most useful setup 
  158. IHELP's cycle and zoom on f1, f2 and tile, cascadeleft on f3,f4 along with 
  159. DCLICK=BOTH (actually, set DCLICK to EXPLODE and use C='s click-to-front
  160. utility, its faster).  If you are a keyboard nut, get WindowShuffle by Stefan 
  161. Sticht. Nice to step through cascaded windows :)
  162.  
  163. The REFUSESCREEN is set to ~(#?Workbench#?), and CASCADEHEIGHT,
  164. CASCADELEFT are set to 200 and 140 respectively (NOHEIGHT and NOWIDTH
  165. are set to FALSE).
  166.  
  167. Any bugs or suggestions (this is an "amiga learning" project for me) ... 
  168. Thanks all who have suggested improvements or reported problems!  Special
  169. thanks to Franz Schwarz for the great input!
  170.  
  171. Enjoy!
  172.  
  173. Doug Dyer
  174. ddyer@hubcap.clemson.edu
  175. 131 B Freedom Dr.               4900 Brandywood Dr.
  176. Clemson, SC 29631               Birmingham, AL 35223
  177.  
  178. -----------------------
  179. Version History:
  180.  
  181. 1.0     1/17/92 Inception. 
  182.  
  183. 1.1     1/19/92 Added CASCADELEFT tooltype.  Enhanced cascading to
  184.         ignore non-sizeable windows (so things like toolmanager
  185.         dock are left alone).  Improved depth arranging of cascading
  186.         (now using MoveWindowInFrontOf).
  187.  
  188. 1.2     1/25/92 Added REFUSE tooltype. Added DCLICK tooltype.
  189.         Enhanced performance.  Added ZOOMIT, FRONTIT tooltypes.
  190.  
  191. 1.2.1   1/29/92 Fixed a bug: ZOOM did the same as BOTH.
  192.  
  193. 1.3     3/21/92 Fixed a bug: seems htile and vtile were.. ah.. switched.
  194.         Added REFUSESCREEN, NOHEIGHT, NOWIDTH, STEPLEFT, STEPDOWN, 
  195.         SHOWTITLE tooltypes.
  196.  
  197. 2.0     5/30/92 Better use of LockIBases... (oops).  Cleaner code and
  198.         internal organization. I changed some tooltype names to make 
  199.         more sense.  Added TOBACK, ZOOMTOGGLE, CASCADEHEIGHT and 
  200.         CASCADEWIDTH. Constructed a GUI for configuring it, but haven't 
  201.         hooked it in yet...
  202.  
  203. 2.1     6/17/92 Better use of everything.  Virtual screen support via
  204.         new tool types VISIBLE, VISIBLETOGGLE.  Double clicking on front-
  205.         back gadget will not explode windows.  Double clicking on drawer
  206.         will not explode new window if title happens to now be under the
  207.         pointer.  GUI still not linked in yet, but the commodity is now
  208.         "mature" and highly useable by a wide variety of tastes.
  209.