home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / icon_192.zip / icontool.txt < prev    next >
Text File  |  1999-05-19  |  6KB  |  155 lines
  1.                        === DISCLAIMER ===
  2.  
  3.  
  4. I allow you to use and distribute ICON.EXE freely under the condition 
  5. that I am in no way responsible for any damage or loss you may suffer.
  6.  
  7. Henk Kelder, hkelder@capgemini.nl
  8.  
  9.                 === NOTES ON ICONTOOL ===
  10.  
  11. General
  12.  
  13. ICON.EXE was written in 'plain old' C using the C/2 Set compiler and 
  14. OS/2 2.0 toolkit. No 'Som' programming was used. All information about
  15. abstract objects is gotten out (hacked) off the ini-files. Clearly the
  16. latter is fully UNDOCUMENTED ! (but it seems to work reasonally well.)
  17.  
  18.  
  19. Drag-drop of icons
  20.  
  21. ICON.EXE is a PM program for OS/2 2.0 that I initially wrote because I did
  22. not like the complex way to set an icon for a workplace shell object and 
  23. other objects (read: files and directories) on my harddisk of attached
  24. network drives. 
  25. Furthermore, since the workplace shell claims to support drag-drop 
  26. operations I wanted to experiment with this. Why shouldn't I be able to drag
  27. an iconfile and drop it on something else so that the icon would be assigned
  28. to this something else.
  29.  
  30. Initialy I tried to write it so it would show icons only and one could then
  31. drag the icon on an object on the desktop. Unfortunately the desktop itself
  32. doesn't seem to follow the specifications for drag-drop operations
  33. completely. The solutions for this was that ICONTOOL allows you to open two
  34. windows and you can do draging and dropping between these two windows.
  35.  
  36.  
  37. Changing directories or drives (open other folders)
  38.  
  39. When icontool is configured to show drives and/or directories you can simply
  40. change to these drives and/or directories by selecting 'open' or by double 
  41. clicking on them. Icontool will no open a new folder but will replace the
  42. contents of the open window.
  43.  
  44.  
  45. Copying, moving and deleting of objects
  46.  
  47. Although not it main purpose, you could also use this program to do these
  48. operations on most objects.
  49.  
  50.  
  51.  
  52. Changing object titles
  53.  
  54. When the program allowed me to do this I found that I would also like to
  55. change the titles of objects WITHOUT changing the underlying fysical
  56. filename of an object. I found the the workplace shell uses the .LONGNAME
  57. extended attribute, if present, as a title. It was no big deal to show 
  58. these .LONGNAME ea's. (It is an option you can set under 'Open->Settings'.)
  59.  
  60. If ICON.EXE shows longnames, one can change the names as one would change
  61. the name of objects on the desktop. Please remember that only the .LONGNAME
  62. extented attribute is changed and NOT the fysical filename.
  63.  
  64.  
  65. Extracting Icons
  66.  
  67. Another nice feature would be the possibility to 'extract' an icon to an
  68. iconfile. When this option is chosen the program first looks if there is an
  69. an .ICON ea and if so writes this ea as a file to disk. If there is 
  70. no .ICON ea the iconfile is constucted from the icon bitmap as it is visible 
  71. on the screen. In the latter case the iconfile only contains a bitmap for 
  72. the device it is extracted from.
  73.  
  74.  
  75. Setting default Icon
  76.  
  77. Setting the default icon means that the .ICON ea is removed.
  78.  
  79. Abstract objects
  80.  
  81. ICONTOOL also displays abstract objects. In some cases the icon for an
  82. abstract object is somewere deep in an OS/2 dll. In such a case I'm not able
  83. to determine the icon and a questionmark icon is shown.
  84. With Icontool you can open all abstract objects with the exception of the
  85. color palette. This is because the api-call I use to open abstract objects
  86. (WinSetObjectData(hObject, "OPEN=DEFAULT") resets a color palette object to
  87. a 5 by 4 palette all of them being a 'New scheme'.
  88.  
  89.  
  90.  
  91. Known problems:
  92.  
  93. - When draging-dropping to another application (e.g. the workplace shell
  94.   itself) the graphical display gets distorded. This is due to a bug in OS/2
  95.   itself, don't call me, call IBM ! This problem occurs only in the original
  96.   first release of OS/2 2.0 (GA version).
  97.  
  98. - For testing reasons a lot of error and/or warning message are build in.
  99.   Normally you should not see them, but on the Novell Network I work with
  100.   myself I sometimes see 'Not enoug memory' messages. These messages result
  101.   from the Novell Requestor for OS/2 2.0 reporting very L A R G E 
  102.   extended attribute sizes. So don't call me, call Novell !
  103.  
  104.  
  105. Updates in version 1.5:
  106.  
  107. - This version now supports OS/2 2.00.1 beta (32 bits GRE)
  108.  
  109. - Also, the mechanism for reading extended attributes has been improved.
  110.   This was needed because the new 2.00.1 (or 2.01 BETA) appearantly has
  111.   a bug that returns un incorrect size for extented attributes when using
  112.   DosQueryPathInfo.
  113.   Appearantly this same bug appears to be in the Novell Netware Requester, 
  114.   since I haven't seen the problem mentioned above after I made the changes.
  115.  
  116. - Known problems: ICON.EXE terminates or causes your desktop to hang
  117.                   when starting in WINOS/2 Program
  118.                   in the early 2.00.1 BETA version. It works properly in GA version.
  119.  
  120. Updates in version 1.6:
  121.  
  122. - Icon.exe now works properly after the service pack (October 1992) has
  123.   been installed!.
  124.  
  125.  
  126. Updates in version 1.61:
  127.  
  128. - ICON.EXE allows the user to specify a directory where extracted icons
  129.   will be placed. (open->settings)
  130.  
  131. - ICON.EXE now works properly with OS/2 2.1 BETA. (Released december '92)
  132.  
  133.  
  134. Updates in version 1.70:
  135.  
  136. - ICON.EXE now works properly with OS/2 2.1 BETA (Released march '93)
  137.  
  138.  
  139. Update in version 1.80:
  140.  
  141. -  ICON.EXE now works with OS/2 3.0 (or WARP)
  142.  
  143. -  ICON.EXE allows you to modify several extended attributes.
  144.  
  145. Update in version 1.90:
  146.  
  147. -  ICON.EXE now utilizes WPTOOLS.DLL to query object settings, both
  148.    formatted and unformatted.
  149.  
  150. -  ICON.EXE still works very nice with WARP 4.
  151.  
  152. Update in version 1.91:
  153. -  Didn't recoqnize objecthandles with a 4 in the hiword as an file system
  154.    object.
  155.