home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / tools / extdesk / readme.txt < prev   
Encoding:
Text File  |  1993-06-24  |  9.4 KB  |  253 lines
  1.              (c) Copyright IBM Corporation 1993.
  2.                    All Rights Reserved.
  3.  
  4.  
  5.                    Extended Desktop
  6.  
  7.                          by
  8.  
  9.                      Dan Campbell
  10.  
  11.  
  12.  
  13. REQUIREMENTS
  14. ------------
  15.  
  16. 1) OS/2 2.0
  17. 2) Service Pack -- This is the absolute minimum!
  18.  
  19.   Make sure that "Always maintain sort order" is not checked on the
  20. Sort Page of the Desktop Settings notebook, before you install.
  21.  
  22.  
  23. INSTALLATION
  24. ------------
  25.  
  26. 1)  If you have a previous level of Extended Desktop installed, See
  27.     "UPGRADE" below or follow REMOVAL instructions below.
  28. 2)  Copy EXTDESK.DLL to a directory that is listed in your LIBPATH
  29.     in CONFIG.SYS
  30. 3)  Run EXTINST.EXE
  31. 4)  Shutdown and reboot.
  32.  
  33.  
  34. REMOVAL
  35. -------
  36.  
  37. 1)  Run EXTREMOV.EXE
  38. 2)  Shutdown and reboot.
  39. 3)  Erase EXTDESK.DLL if you wish.
  40.  
  41.  
  42.  
  43. UPGRADE
  44. -------
  45.  
  46.    It is possible to update the DLL without going through the full
  47. process of REMOVAL followed by another INSTALLATION.  A simple addition
  48. to CONFIG.SYS will cause EXTDESK.DLL to be updated automatically the
  49. next time you boot.
  50.    To replace EXTDESK.DLL with a new version on the next boot, add
  51. the following line anywhere in CONFIG.SYS ( I put it at the top ):
  52.  
  53.     CALL=x:\OS2\XCOPY.EXE srcpath\EXTDESK.DLL destpath
  54.  
  55. where "x" is the boot drive on your system, "srcpath" is the full
  56. path of the directory where you download new versions of EXTDESK,
  57. and "destpath" is the full path where you put the working copy of
  58. EXTDESK.DLL.  "srcpath" should be a directory that does NOT appear
  59. in your LIBPATH.  "destpath" must be a directory that DOES appear
  60. in your LIBPATH.
  61.    For example,  I put new copies of EXTDESK.DLL in the EXTDESK
  62. directory on my E: drive, and put the working copy in the C:\OS2\DLL
  63. directory.  The line in my CONFIG.SYS is:
  64.  
  65.     CALL=C:\OS2\XCOPY.EXE E:\EXTDESK\EXTDESK.DLL C:\OS2\DLL\
  66.  
  67.  
  68.  
  69.  
  70. WHAT DOES IT DO?
  71. ----------------
  72.  
  73.    EXTINST registers the ExtendedDesktop Class, then  uses a
  74. public API in OS/2 to "replace" the WPDesktop class with the
  75. ExtendedDesktop class.  Any objects of the WPDesktop class will
  76. exhibit the behavior of the ExtendedDesktop class.  A reboot is
  77. required for it to take effect.
  78.    I do NOT modify CONFIG.SYS.  Everything about your current setup
  79. ( settings, icon positions, etc ) remains untouched.  The only changes
  80. you will see are:  1)  Sort and Arrange will be absent from the Desktop
  81. context menu, 2) an Align item and a Snap-to-Grid item will be added to
  82. the Desktop context menu, 3) 2 Arrange settings pages will be in the 
  83. Desktop Settings notebook, 4) an Icons settings page will be added
  84. to the Desktop Settings notebook, and 5) The Sort settings page will
  85. be absent from the Desktop Settings notebook.
  86.  
  87.  
  88.  
  89.  
  90. THE ARRANGE SETTINGS PAGE 1 OF 2
  91. --------------------------------
  92.  
  93.    The Arrange settings page allows you to choose how you wish to
  94. be protected from accidental arrange.  You have two choices:
  95. 1) Arrange and Sort will be removed from the Desktop context menu (and
  96. the Sort Page will be removed from the Desktop Settings notebook), or
  97. 2) Selecting Arrange or Sort from the Desktop context menu will cause
  98. a confirmation dialog to popup.
  99.    The "Arrange Minimized Windows" check box allows you to choose
  100. whether to allow Arrange for Windows that are minimized to the Desktop.
  101. The default is No.  If this box is checked,  an "Arrange Minimized" context
  102. menu item will be added to the Desktop context menu.
  103.    The "Snap to Grid" check box allows you to choose whether the menu
  104. item labeled "Snap to Grid" will appear on the Desktop context menu.
  105.  
  106.  
  107.  
  108.  
  109. THE ARRANGE SETTINGS PAGE 2 OF 2
  110. --------------------------------
  111.  
  112.    The "Deselect after Align" checkbox allows you to choose whether
  113. the selected items will remain selected after an Align operation.  If
  114. it is checked, all selected items will be deselected after the Align
  115. operation.  The default is for them to remain selected.
  116.    The "Even Spacing on Align" check box allows you to choose whether
  117. Icons will be spaced evenly when aligned.  If this box is checked,
  118. selected icons will be evenly spaced between the two icons on the ends
  119. of the selected group.  Note that this may move icons such that they no
  120. longer conform to the grid.
  121.    Page 2 of the Arrange Settings also has two spin buttons for setting
  122. the Grid Spacing for the "Snap to Grid" function.
  123.  
  124.  
  125.  
  126. THE "Snap to Grid" MENU ITEM ON THE DESKTOP CONTEXT MENU
  127. --------------------------------------------------------
  128.  
  129.    This menu item only appears if the "Snap to Grid" checkbox is checked
  130. on Arrange Settings Page 1.
  131.    Selecting this menu item causes objects on the Desktop to be moved
  132. so that their x- and y-coordinates are multiples of the values set on
  133. Arrange Settings Page 2.  Objects will not be moved if they already
  134. conform to the grid spacing.  If moving an object would place it at the
  135. same (x,y) location as another object, the second object will be moved
  136. one grid spacing to the right.
  137.  
  138.  
  139.  
  140. THE "Arrange Minimized" MENU ITEM ON THE DESKTOP CONTEXT MENU
  141. -------------------------------------------------------------
  142.  
  143.    This menu item only appears if the "Arrange Minimized Windows" box
  144. is checked on Arrange Settings Page 1.
  145.    Selecting this menu item  causes Windows that are minimized to the
  146. Desktop to be rearranged just as they would be without ExtendedDesktop
  147. installed.
  148.  
  149.  
  150.  
  151. THE ALIGN CASCADE MENU ON THE DESKTOP CONTEXT MENU
  152. --------------------------------------------------
  153.  
  154.    This item on the Desktop context menu allows you to align a group
  155. of objects on the Desktop either vertically or horizontally.  
  156.    To use this, first select a group of objects on the Desktop in one
  157. of the following three ways:
  158.  
  159. 1) a. Move the mouse pointer to the first object you want to select.
  160.    b. Press and hold mouse button 1; then move the pointer over the
  161.       objects to be selected.
  162.    c. Release the mouse button.
  163. NOTE: Objects will be aligned with object that was selected last.
  164.  
  165.   Or:
  166.  
  167. 2) a. Move the mouse pointer to the first object you want to select.
  168.    b. Press and hold the Ctrl key.
  169.    c. While holding the Ctrl key, click mouse button 1 on each object
  170.       to be selected.
  171. NOTE: Objects will be aligned with object that was selected last.
  172.  
  173.   Or:
  174.  
  175. 3) a. Click mouse button 1 on the object with which you want other 
  176.       objects to be aligned.
  177.    b. Move the mouse pointer to just outside the objects you want to
  178.       select.
  179.    c. Press and hold mouse button 1; then move the pointer to draw a
  180.       box arround the objects to be selected ( including the object
  181.       selected in step a).
  182.    d. Release the mouse button.
  183. NOTE: Objects will be aligned with object that was selected in step a.
  184.  
  185.    If you wish to align the icons vertically, select "Vertically" from the
  186. Align cascade on the Desktop context menu.  If you wish to align the icons
  187. horizontally, select "Horizontally" from the Align cascade on the 
  188. Desktop context menu.
  189.    Aligning vertically changes the x-coordinate of all selected objects
  190. to be the same.  The y-coordinates will not change.  Aligning horizontally
  191. changes the y-coordinate of all selected objects to be the same.  The 
  192. x-coordinates will not change.  Therefore, it is possible to position 
  193. objects on top of each other, if you're not careful.
  194.  
  195.  
  196.  
  197.  
  198. THE ICONS SETTINGS PAGE
  199. -----------------------
  200.  
  201.    The Icons settings page allows you to precisely position any icon
  202. on the Desktop.  On this page, the title text of each object on the
  203. Desktop appears in a listbox.  When you select an item in the listbox,
  204. the corresponding object on the Desktop will be hilighted.  Also, its
  205. x- and y-coordinates will appear in the two spin buttons below the
  206. listbox.  You can then position the object on the Desktop by changing
  207. the values in the spin buttons.
  208.    Selecting an Icon on the Desktop will cause the corresponding item
  209. in the listbox to be selected.
  210.  
  211.  
  212.  
  213.  
  214. POSITIONING AN ICON FROM REXX OR C
  215. ----------------------------------
  216.  
  217.    It is possible to position an individual icon from a REXX or C program.
  218. This is done using SysSetObjectData from REXX, or WinSetObjectData from C.
  219. The data is a character string of the following form:
  220.  
  221.              "MOVEICON=title;X=n;Y=m;"
  222.  
  223. where "title" is the Icon's title text, "n" is the desired x-coordinate,
  224. and "m" is the desired y-coordinate.  The title only needs to be long
  225. enough to uniquely identify the object ( e.g., specifying "Shred" would
  226. move the Shredder, as long as there wasn't anothere object title beginning
  227. with "Shred" ).  The title may contain spaces, however, the case must be 
  228. exact.  If the title contains line breaks, place a caret in the title at
  229. the point of the line break ( e.g. if the Master Index title text contains
  230. line break, the string would be "MOVEICON=Master^Index;X=100;Y=100;" ).
  231.  
  232.    From REXX, an Object on the Desktop may be positioned using the
  233. SysSetObjectData REXX Utility Function.  A sample REXX program that
  234. moves the Shredder to x=200, y=300 would look like this:
  235.  
  236.    /* move the Shredder */
  237.    call RxFuncAdd 'SysLoadFuncs','RexxUtil','SysLoadFuncs'
  238.    call SysLoadFuncs
  239.  
  240.    call SysSetObjectData "<WP_DESKTOP>","MOVEICON=Shredder;X=200;Y=300;"
  241.  
  242.  
  243.    From C, an Object on the Desktop may be positioned using WinSetObjectData.
  244. A sample C code fragment that moves the Shredder to x=200, y=300 would look 
  245. like this:
  246.  
  247.    /* move the Shredder */
  248.    WinSetObjectData(WinQueryObject("<WP_DESKTOP>"),"MOVEICON=Shredder;X=200;Y=300;");
  249.  
  250.  
  251.  
  252.  
  253.