home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1998 February / PCO_0298.ISO / filesbbs / os2 / hotc20.arj / HOTC20.ZIP / readme.doc < prev    next >
Encoding:
Text File  |  1997-11-20  |  11.8 KB  |  326 lines

  1. Hot Corners 2.0              (C) 1997 Samuel Audet <guardia@cam.org>
  2.  
  3. THIS IS A FREEWARE UTILITY!!  Please send an e-mail if are using this
  4. program, thank you!  If you can spare some money for a pre-university
  5. student, it would be very much appreciated.
  6.  
  7. Contents
  8. --------
  9.  
  10.    1. Introduction
  11.    2. Installation
  12.    3. General Usage
  13.       3.1 Window Lists
  14.       3.2 Objects
  15.       3.3 Options
  16.    4. Things to come
  17.    5. Author's recommendations
  18.    6. For Programmers
  19.    7. Legal Stuff
  20.    8. Acknowledgments
  21.    9. Contacting the author
  22.  
  23.  
  24. 1. Introduction
  25. ---------------
  26.  
  27. I was always interested by the way Screen Savers and Object Desktop windows
  28. would activate by hitting a corner or a border of the screen edge.
  29. Unfortunately, they only supported windows that they own.  So when I
  30. learned enough about programming, this is what I decided to do for my first
  31. PM program.  It lets you select any windows from the window list that you
  32. would like to come up when you hit a border or a corner of the screen as
  33. well as opening objects. It is very useful when you need windows/programs
  34. to be frequently foreground, but not always.  It can also start objects.
  35.  
  36. For example, needing to fuss around with background/foreground windows just
  37. to get to Memsize, or to find a piece of desktop, somewhere, to bring up
  38. Window List or WarpCenter was just plain frustrating... and even utilities
  39. that allow you to click on any window to bring things up are not that
  40. interesting. (ie.: "<censored>, I pressed the Cancel button...")
  41.  
  42. This program _DOES NOT_ modify anything in your system, not even OS2.INI
  43. (WPSExtS.dll registeration will though).  It will use the first HOTHOOK.DLL
  44. it finds in LIBPATH (usually the current directory) and only read/write
  45. from HOTCORN.INI where HOTCORN.EXE resides.
  46.  
  47. Oh and by the way, in case of error, Hot Corners will never display
  48. annoying dialog boxes, instead it will display them in red at the bottom of
  49. the main window.  A beep and a warning is given if a second copy of Hot
  50. Corners is loaded.
  51.  
  52.  
  53. 2. Installation
  54. ---------------
  55.  
  56. If you want to use the Object part properly, you will need OS/2 Warp 3 and
  57. will need to register WPSAgentSam from WPSExtS.dll and replace WPObject.
  58. Regagent.exe is provided for this purpose.  This is the same DLL than in
  59. Open 2.0 package, but register with regagent.exe just to be sure everything
  60. is OK with Hot Corners.  Current version of WPS Extention DLL is 1.0, I
  61. will try to make all new versions backward compatible.
  62.  
  63. In OS/2 Warp 4, to easily create a Program Object to place into your
  64. Startup folder, use the "Create Program Object" item in the context menu of
  65. HOTCORN.EXE.
  66.  
  67. The state and position of Hot Corners' main window is saved each time it
  68. gets closed (properly).  This means that when you have finished choosing
  69. and saving your settings, just minimize the window, be sure a Hot Corners
  70. program object is in your startup folder, and next time you shutdown and
  71. boot up, it will be minimized ready to do its job.
  72.  
  73. HELP!!  Objects don't work...!!  Ok, here are some steps you can follow,
  74. x: being your boot drive, and the current directory being where you have
  75. unzipped Hot Corners:
  76.  
  77.    1. type "copy wpsexts.dll x:\os2\dll"
  78.    2. type "regagent i"
  79.    3. shutdown
  80.    4. reboot
  81.  
  82.  
  83. 3. General Usage
  84. ----------------
  85.  
  86. To make list box changes active, you have to double click or Enter the
  87. listbox.  Pressing OK will make changes active for all list boxes. Pressing
  88. Save will save the selections (and the options) in the INI file in addition
  89. to Entering the list boxes, and Reload will reload everything from INI (as
  90. if you closed and reopened Hot Corners).  All the checkboxes and spinbutton
  91. take effect immediately.
  92.  
  93.  
  94. The following is for "keyboard junkies"...
  95.  
  96. Special keyboard combinations:
  97.  
  98.    General
  99.  
  100.       Tab & Shift-Tab    Goes to the next and previous
  101.                          dialog item in current dialog.
  102.  
  103.       Arrows             Circulates through items of same type
  104.                          (ie.: buttons, tabs, list boxes, etc.)
  105.  
  106.    In Notebook and Main window:
  107.  
  108.       Alt-Up        Gives focus to the notebook.
  109.       Alt-Down      Gives focus to the buttons.
  110.       Mnemonic      Performs corresponding action.
  111.       Alt-Mnemonic  Same as above, but those are actually accelerator keys
  112.                     and global.
  113.  
  114.    In Notebook window:
  115.  
  116.       Alt-Page Up   Shows Previous page.
  117.       Alt-Page Down Shows Next page.
  118.   
  119.    In Window Lists window
  120.  
  121.       Space         Selects and deselects entries.
  122.       Enter         Activates the changes made to that list box.
  123.    
  124.    In Objects window
  125.    
  126.       Shift-Arrows  Selects while moving.
  127.       Shift-F8      Starts multiple selection.
  128.       Shift-F11     Shows pop-up menu.
  129.       Enter         Activate the changes made to that list box.
  130.       Insert        Shows the file dialog to Add data file items.
  131.       Delete        Deletes the selected items.
  132.  
  133.    In Options window
  134.  
  135.       Up and Down   Increments and decrements timeout value by 10.
  136.  
  137. The notebook page windows seem to be a world apart from the rest of the main
  138. window.  I can't figure out the relation between them and the notebook
  139. window, neither can I tell why the keyboard accelerator don't work in them
  140. or why the notebook window doesn't receive WM_CHAR messages from them.
  141. Sorry :(  If anybody figured out that mystery, please let me know.
  142.  
  143.  
  144. 3.1 Window Lists
  145. ----------------
  146.  
  147. You just need to choose anything you want to bring foreground when hitting
  148. a corner or a border.
  149.  
  150. "Bring to pointer position" will move the windows that are switched to to
  151. the mouse pointer position.
  152.  
  153. "Minimize on pointer leave" will minimize/hide the windows that has been
  154. brought up when the mouse pointer leaves the window frame. (magic, isn't?)
  155.  
  156. The listboxes are refreshed each time their page comes up, and of course if
  157. you make the current page come up, it will refresh also.  Note that the
  158. changes will not take effect until you double click, enter, push OK or
  159. Save.  Therefore, even if windows previously selected get closed, just make
  160. sure you do not activate the changes.
  161.  
  162. Note: weird Window List entries you might see:
  163.  
  164.    - PMSPOOL.EXE      Huum... beats me why PMSPOOL.EXE includes such en
  165.                       ugly name in the window list, maybe the printers need
  166.                       to find the spooler in the window list.  In any case,
  167.                       it cannot come foreground (invisible).
  168.  
  169.    - Workplace Shell  This entry is added by Workplace Shell process.  I
  170.                       don't know much more about it, except that it is not
  171.                       of any use to try to switch to it.  This is not the
  172.                       same as "Desktop".
  173.  
  174.    - 'space'          This is cute gray elephant registration window,
  175.                       ARTCHRON, but it does not want to come up foreground
  176.                       (invisible also).
  177.  
  178.    - Switch to        This is the Window List!  You can make the window
  179.                       list come up this way.  It is always the last entry.
  180.  
  181. I could filter them, and ask PM and the WPS for more information on the
  182. other entries a la Window List, but is this really necessary?
  183.  
  184.  
  185. 3.2 Objects
  186. -----------
  187.  
  188. Dragging objects in the listbox, or adding files with the file dialog, will
  189. show the path and the title of the object just as an indication to the
  190. user.  In no way does Hot Corners bases its research on the path and title
  191. of the object.  It will even get modified if the object moves or is
  192. renamed.
  193.  
  194.  
  195. 3.3 Options
  196. -----------
  197.  
  198. Here, there is only one option for the moment.  The timeout delay is the
  199. amount of time needed for the mouse pointer to stay on the border or on the
  200. corner to execute the corresponding action.  This way, you will have less
  201. risk of an undesirable switch or open when moving your mouse pointer near
  202. the borders.
  203.  
  204.  
  205. 4. Things to come (maybe)
  206. -------------------------
  207.  
  208. - Adding "half-split borders"
  209. - Adding an indication of activated borders and corners
  210. - Adding a timeout delay for _each_ border and corner
  211.  
  212. - If people have _good_ ideas, I will add more features!
  213.  
  214.  
  215. 5. Author's recommendation
  216. --------------------------
  217.  
  218. Personally, I use Hot Corners on the Warp Center, 9 lives, Memsize, the
  219. Window List and some commonly used folders like Incoming and MP3. ;-)
  220.  
  221. If you like this program, you will surely like the other utilities I use.
  222. Here are the absolutely needed PM utilities that *EVERYBODY* should have:
  223.  
  224.    - TITLE.DLL (you can put a window last in the Z order with a click just
  225.      like X-Windows!!)
  226.  
  227.    - 9 Lives (probably the only _usable_ virtual desktop utility apart
  228.      from Object Desktop's.  Virtual Desktop concept is so advanced on
  229.      anything else!)
  230.  
  231.    - System Resources, AKA Memsize (the coolest system monitor out there,
  232.      be sure to use a nice small font, reduce the length of the
  233.      descriptions, and change the ugly colors)
  234.  
  235.    - Command Folder (lets you drop to any type of command line using a new
  236.      entry placed in folders' context menu)
  237.  
  238.    - Open (lets you objects from OS/2 command line using WPS associations)
  239.  
  240.    - Newdlg (a bigger, more usable and with smaller fonts File Dialog
  241.      window replacement)
  242.  
  243.    - WarpCenter HotKey (brings up the menu of the button with the OS/2 Warp
  244.      logo of the WarpCenter with a hotkey)
  245.  
  246.    - Warp Enhancer (various lil things, but mainly folder status bar)
  247.         Be careful with this one -> current of today's version 0.25, I
  248.         frequently get WPS crash in PMVIOP.DLL when opening folders.
  249.  
  250. I make all of them available from my home page http://www.cam.org/~guardia
  251.  
  252. With these in the pocket, you will be using PM more efficiently that you
  253. might never have imagined!!
  254.  
  255. I heard other people liked these, although I do not really...
  256.  
  257.    - Xit      http://www.wilmington.net/bmtmicro/catalog/xit/xit.html
  258.    - X File   http://www.wilmington.net/bmtmicro/catalog/xfile
  259.    - NPS WPS  http://www.sf.airnet.ne.jp/~ts/npswps
  260.    - Program Commander/2
  261.         http://www.geocities.com/SiliconValley/Pines/7885/DownloadPC2Beta.html
  262.  
  263. Object Desktop is a great, but huuuggee desktop enhancer.  From my
  264. experience, it is stable (version 1.5.2), but unless you have CPU cycles
  265. and memory to waste, do not use it.  I truly recommend Stardock to reduce
  266. the bloat of this beast (by pushing IBM to release a better WPS Reference).
  267. It is partly because I don't use it anymore that I made Hot Corners.
  268. http://www.stardock.com
  269.  
  270. Have fun!  And do not forget to send e-mail if you like it, or if you have
  271. any other comments, suggestions. . .. or bug report.
  272.  
  273.  
  274. 6. For Programmers
  275. ------------------
  276.  
  277. If you want to include things you have seen in Hot Corners' object support
  278. in your own program, read wpsext.doc.
  279.  
  280.  
  281. 7. Legal stuff
  282. --------------
  283.  
  284. This freeware product is used at your own risk, although it is highly
  285. improbable it can cause any damage.
  286.  
  287. If you plan on copying me, please give me the credits, thanks.
  288.  
  289. Source code is freely available, and done with VisualAge C++ 3.0.  I will
  290. send them to you on request unless you are planning to make money with it,
  291. in which case I would want to have a bit of $$$ for it.
  292.  
  293.  
  294. 8. Acknowledgments
  295. ------------------
  296.  
  297. Thanks goes to:
  298.  
  299. Rick Papo <rpapo@msen.com>  Il parle francais aussi! :)
  300. Michael Shillingford <mshill@elkvalley.net> for his Hook articles on EDM/2
  301. Rick Fishman  (for NBBASE, found many good ideas... that I enhanced)
  302.  
  303. IRC people:
  304.  
  305. Taneli Leppa <bandit@icenet.fi>
  306. William Young <young@young.dungeon.com>
  307. Robert Mahoney <rmahoney@netusa.net>
  308. Chris Elving <elving@enel.ucalgary.ca>
  309. Peter Fitzsimmons <pfitz@ican.net>
  310.  
  311.  
  312. 8. Contacting the author
  313. ------------------------
  314.  
  315. Samuel Audet
  316.  
  317. E-mail:    guardia@cam.org
  318. Homepage:  http://www.cam.org/~guardia
  319. IRC nick:  Guardian_ (be sure it is I before starting asking questions though)
  320.  
  321. Snail Mail:
  322.  
  323.    377, rue D'Argenteuil
  324.    Laval, Quebec
  325.    H7N 1P7   CANADA
  326.