home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / i / icon_161.zip / ICON.HLP (.txt) < prev    next >
OS/2 Help File  |  1993-01-21  |  14KB  |  378 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. About ICONTOOL ΓòÉΓòÉΓòÉ
  3.  
  4. ICONTOOL by Henk Kelder 
  5.  
  6. ICONTOOL allows you to do the following things: 
  7.  
  8. o Change an objects icon by dropping an icon on it. 
  9. o Change the name shown on the workplace shell without changing the name on 
  10.   disk. 
  11. o Copy and move non-abstract files and directories. 
  12. o Delete objects. 
  13. o Extract icons from objects. 
  14. o Open objects and change objects settings. 
  15.  
  16. See the following for more information: 
  17.  
  18. Disclaimer 
  19. General information 
  20. Changing directories and drives 
  21. Manipulating files 
  22. Changing object titles 
  23. Extracting icons 
  24. Setting the default icon 
  25. Abstract objects 
  26. Known problems in ICONTOOL 
  27. Changes in version nnn 
  28. ICONTOOL.TXT 
  29.  
  30.  
  31. ΓòÉΓòÉΓòÉ 2. General Help ΓòÉΓòÉΓòÉ
  32.  
  33. Use this choice to get general help for the program. General help provides 
  34. general information about the Association editor. 
  35.  
  36.  
  37. ΓòÉΓòÉΓòÉ 3. Extended ΓòÉΓòÉΓòÉ
  38.  
  39. Use this choice to obtain information on how to use the Help facility. 
  40.  
  41.  
  42. ΓòÉΓòÉΓòÉ 4. Index ΓòÉΓòÉΓòÉ
  43.  
  44. Use this choice to display the help index. 
  45.  
  46. The help index lists the titles of the help information that is available. 
  47.  
  48.  
  49. ΓòÉΓòÉΓòÉ 5. Tutorial of Keys ΓòÉΓòÉΓòÉ
  50.  
  51. Use this choice to see a list of keys and a description of the function of the 
  52. keys. 
  53.  
  54.  
  55. ΓòÉΓòÉΓòÉ 6. Information ΓòÉΓòÉΓòÉ
  56.  
  57. This dialog displays information about the application, such as version number 
  58. and the author. 
  59.  
  60.  
  61. ΓòÉΓòÉΓòÉ 6.1. Keys Help ΓòÉΓòÉΓòÉ
  62.  
  63. ICONTOOLs conforms itself to the general usage of keys for folders. If you need 
  64. information about these keys, select an icon on your desktop and select Keys 
  65. Help from the menu. 
  66.  
  67.  
  68. ΓòÉΓòÉΓòÉ 7. Disclaimer ΓòÉΓòÉΓòÉ
  69.  
  70. I allow you to use and distribute ICON.EXE freely under the condition that I am 
  71. in no way responsible for any damage or loss you may suffer. 
  72.  
  73. Henk Kelder 
  74.  
  75.  
  76. ΓòÉΓòÉΓòÉ 8. General information ΓòÉΓòÉΓòÉ
  77.  
  78. ICON.EXE was written in 'plain old' C using the C/2 Set compiler and OS/2 2.0 
  79. toolkit. No 'SOM' programming was used. All information about abstract objects 
  80. is gotten out (hacked) off the ini-files. Clearly the latter is fully 
  81. UNDOCUMENTED ! (but it seems to work reasonally well.) 
  82.  
  83. ICON.EXE is a PM program for OS/2 2.0 that I initially wrote because I did not 
  84. like the complex way to set an icon for a workplace shell object and other 
  85. objects (read: files and directories) on my harddisk and of attached network 
  86. drives. 
  87.  
  88. Furthermore, since the workplace shell claims to support drag-drop operations I 
  89. wanted to experiment with this. Why shouldn't I be able to drag an iconfile and 
  90. drop it on something else so that the icon would be assigned to this something 
  91. else. 
  92.  
  93. Initialy I tried to write it so it would show icons only and one could then 
  94. drag the icon on an object on the desktop. Unfortunately the desktop itself 
  95. doesn't seem to follow the specifications for drag-drop operations completely. 
  96. The solutions for this was that ICONTOOL allows you to open two windows and you 
  97. can do draging and dropping between these two windows. 
  98.  
  99.  
  100. ΓòÉΓòÉΓòÉ 9. Changing directories and drives ΓòÉΓòÉΓòÉ
  101.  
  102. When ICONTOOL is configured to show drives and/or directories you can simply 
  103. change to these drives and/or directories by selecting 'open' or by double 
  104. clicking on them. ICONTOOL will no open a new folder but will replace the 
  105. contents of the open window. 
  106.  
  107.  
  108. ΓòÉΓòÉΓòÉ 10. Manipulating files or directories ΓòÉΓòÉΓòÉ
  109.  
  110. Although not it main purpose, you could also use this program to do the 
  111. following operations on most objects: 
  112.  
  113. Copy files 
  114.  
  115. You can copy a file or directory the by dragging it to another location while 
  116. you keep the control-button pressed. This can be the second window ICONTOOL 
  117. allows you to open, but it can also be a workplace shell folder. 
  118. You cannot copy abstract objects with ICONTOOL! 
  119.  
  120. Move files 
  121.  
  122. You can move a file or directory by dragging it to another location without 
  123. pressing any keys. This can be the second window ICONTOOL allows you to open, 
  124. but it can also be a workplace shell folder. 
  125. You cannot move abstract objects with ICONTOOL! 
  126.  
  127. Make shadows of files or directories 
  128.  
  129. You can make a shadow of a file by dragging it to another location while 
  130. pressing the control and shift key. This can not be the second window ICONTOOL 
  131. allows you to open, but it can be a workplace shell folder. 
  132. You cannot make shadows of abstract objects with ICONTOOL! 
  133.  
  134. Note:  The here mentioned key combinations can be different on your desktop if 
  135. you have changed the defaults. 
  136.  
  137. Related information: 
  138.  
  139. Abstract objects 
  140.  
  141.  
  142. ΓòÉΓòÉΓòÉ 11. Changing object titles ΓòÉΓòÉΓòÉ
  143.  
  144. When the program allowed me to do this I found that I would also like to change 
  145. the titles of objects WITHOUT changing the underlying fysical filename of an 
  146. object. I found the the workplace shell uses the .LONGNAME extended attribute, 
  147. if present, as a title. It was no big deal to show these .LONGNAME ea's. (It is 
  148. an option you can set under 'Open->Settings'.) 
  149.  
  150. If ICON.EXE shows longnames, one can change the names as one would change the 
  151. name of objects on the desktop. Please remember that only the .LONGNAME 
  152. extented attribute is changed and NOT the fysical filename. 
  153.  
  154. You can change names by using the standard way to rename workplace shell 
  155. objects (alt and leftmouse button or shift-f9). 
  156.  
  157.  
  158. ΓòÉΓòÉΓòÉ 12. Extracting icons ΓòÉΓòÉΓòÉ
  159.  
  160. Another nice feature would be the possibility to 'extract' an icon to an 
  161. iconfile. When this option is chosen the program first looks if there is an 
  162. .ICON ea and if so writes this ea as a file to disk. If there is no .ICON ea 
  163. the iconfile is constucted from the icon bitmap as it is visible on the screen. 
  164. In the latter case the iconfile only contains a bitmap for the device it is 
  165. extracted from. 
  166.  
  167. You can extract an icon from an object by selecting the extract option from the 
  168. objects popup menu. 
  169.  
  170.  
  171. ΓòÉΓòÉΓòÉ 13. Setting the default icon ΓòÉΓòÉΓòÉ
  172.  
  173. Setting the default icon means that the .ICON ea is removed. 
  174.  
  175. You can set the default icon for an object by selecting the default option from 
  176. the objects popup menu. 
  177.  
  178.  
  179. ΓòÉΓòÉΓòÉ 14. Abstract objects ΓòÉΓòÉΓòÉ
  180.  
  181. Wat is an abstract object? 
  182.  
  183. An abstract object is an object that is defined in your ini-files. Non-abstract 
  184. are always present on a disk as a file or a directory. 
  185. An example of an abstract object is the color palette. 
  186.  
  187. Icons shown for abstract objects 
  188.  
  189. ICONTOOL also displays abstract objects. In some cases the icon for an abstract 
  190. object is somewere deep in an OS/2 dll. In such a case I'm not able to 
  191. determine the icon and a questionmark icon is shown. 
  192.  
  193. Opening abstract objects 
  194.  
  195. With ICONTOOL you can open all abstract objects with the exception of the color 
  196. palette. This is that the api-call I use to open abstract objects 
  197. (WinSetObjectData(hObject, "OPEN=DEFAULT") resets a color palette object to a 5 
  198. by 4 palette all of them being a 'New scheme'. 
  199.  
  200. Deleting abstract objects 
  201.  
  202. ICONTOOL allows you to delete abstract objects, including non-deleteable 
  203. objects 
  204.  
  205.  
  206. ΓòÉΓòÉΓòÉ 15. Known problems ΓòÉΓòÉΓòÉ
  207.  
  208. When draging-dropping to another application (e.g. the workplace shell itself) 
  209. the graphical display gets distorded. This is due to a bug in OS/2 itself, 
  210. don't call me, call IBM ! This problem only appears in the original GA version. 
  211.  
  212. ICON.EXE terminates or causes your desktop to hang when starting in WINOS2 
  213. Program in early OS/2 2.00.1 BETA version. It works properly in GA, GA+SP, and 
  214. BETA 2.1 version. 
  215.  
  216. When showing a dir 
  217.  
  218.  
  219. ΓòÉΓòÉΓòÉ 16. Changes in version x.xxx ΓòÉΓòÉΓòÉ
  220.  
  221. Version 1.5 
  222.  
  223. This version now supports OS/2 2.00.1 beta (32 bits GRE). 
  224.  
  225. Also, the mechanism for reading extended attributes has been improved. This was 
  226. needed because the new 2.00.1 (or 2.01 BETA) appearantly has a bug that returns 
  227. un incorrect size for extented attributes when using DosQueryPathInfo. 
  228.  
  229. On-line help was added. 
  230.  
  231. Version 1.60 
  232.  
  233. Icon.exe now works properly after the service pack (October 1992) has been 
  234. installed!. 
  235.  
  236. Version 1.61 
  237.  
  238. ICON.EXE allows the user to specify a directory where extracted icons will be 
  239. placed. (open->settings) 
  240.  
  241. ICON.EXE now works properly with OS/2 2.1 BETA. (Released december '92) 
  242.  
  243.  
  244. ΓòÉΓòÉΓòÉ 17. ICONTOOL.TXT ΓòÉΓòÉΓòÉ
  245.  
  246.             === DISCLAIMER ===
  247.  
  248.  
  249. I allow you to use and distribute ICON.EXE freely under the condition
  250. that I am in no way responsible for any damage or loss you may suffer.
  251.  
  252. Henk Kelder
  253.  
  254.  
  255.         === NOTES ON ICONTOOL 1.3 ===
  256.  
  257. General
  258.  
  259. ICON.EXE was written in 'plain old' C using the C/2 Set compiler and
  260. OS/2 2.0 toolkit. No 'Som' programming was used. All information about
  261. abstract objects is gotten out (hacked) off the ini-files. Clearly the
  262. latter is fully UNDOCUMENTED ! (but it seems to work reasonally well.)
  263.  
  264.  
  265. Drag-drop of icons
  266.  
  267. ICON.EXE is a PM program for OS/2 2.0 that I initially wrote because I did
  268. not like the complex way to set an icon for a workplace shell object and
  269. other objects (read: files and directories) on my harddisk of attached
  270. network drives.
  271. Furthermore, since the workplace shell claims to support drag-drop
  272. operations I wanted to experiment with this. Why shouldn't I be able to drag
  273. an iconfile and drop it on something else so that the icon would be assigned
  274. to this something else.
  275.  
  276. Initialy I tried to write it so it would show icons only and one could then
  277. drag the icon on an object on the desktop. Unfortunately the desktop itself
  278. doesn't seem to follow the specifications for drag-drop operations
  279. completely. The solutions for this was that ICONTOOL allows you to open two
  280. windows and you can do draging and dropping between these two windows.
  281.  
  282.  
  283. Changing directories or drives (open other folders)
  284.  
  285. When icontool is configured to show drives and/or directories you can simply
  286. change to these drives and/or directories by selecting 'open' or by double
  287. clicking on them. Icontool will no open a new folder but will replace the
  288. contents of the open window.
  289.  
  290.  
  291. Copying, moving and deleting of objects
  292.  
  293. Although not it main purpose, you could also use this program to do these
  294. operations on most objects.
  295.  
  296.  
  297.  
  298. Changing object titles
  299.  
  300. When the program allowed me to do this I found that I would also like to
  301. change the titles of objects WITHOUT changing the underlying fysical
  302. filename of an object. I found the the workplace shell uses the .LONGNAME
  303. extended attribute, if present, as a title. It was no big deal to show
  304. these .LONGNAME ea's. (It is an option you can set under 'Open->Settings'.)
  305.  
  306. If ICON.EXE shows longnames, one can change the names as one would change
  307. the name of objects on the desktop. Please remember that only the .LONGNAME
  308. extented attribute is changed and NOT the fysical filename.
  309.  
  310.  
  311. Extracting Icons
  312.  
  313. Another nice feature would be the possibility to 'extract' an icon to an
  314. iconfile. When this option is chosen the program first looks if there is an
  315. an .ICON ea and if so writes this ea as a file to disk. If there is
  316. no .ICON ea the iconfile is constucted from the icon bitmap as it is visible
  317. on the screen. In the latter case the iconfile only contains a bitmap for
  318. the device it is extracted from.
  319.  
  320.  
  321. Setting default Icon
  322.  
  323. Setting the default icon means that the .ICON ea is removed.
  324.  
  325. Abstract objects
  326.  
  327. ICONTOOL also displays abstract objects. In some cases the icon for an
  328. abstract object is somewere deep in an OS/2 dll. In such a case I'm not able
  329. to determine the icon and a questionmark icon is shown.
  330. With Icontool you can open all abstract objects with the exception of the
  331. color palette. This is that the api-call I use to open abstract objects
  332. (WinSetObjectData(hObject, "OPEN=DEFAULT") resets a color palette object to
  333. a 5 by 4 palette all of them being a 'New scheme'.
  334.  
  335.  
  336.  
  337. Known problems:
  338.  
  339. - When draging-dropping to another application (e.g. the workplace shell
  340.  itself) the graphical display gets distorded. This is due to a bug in OS/2
  341.  itself, don't call me, call IBM ! This problem occurs only in the original
  342.  first release of OS/2 (GA version).
  343.  
  344. - For testing reasons a lot of error and/or warning message are build in.
  345.  Normally you should not see them, but on the Novell Network I work with
  346.  myself I sometimes see 'Not enoug memory' messages. These messages result
  347.  from the Novell Requestor for OS/2 2.0 reporting very L A R G E
  348.  extended attribute sizes. So don't call me, call Novell !
  349.  
  350.  
  351. Updates in version 1.5:
  352.  
  353. - This version now supports OS/2 2.00.1 beta (32 bits GRE)
  354.  
  355. - Also, the mechanism for reading extended attributes has been improved.
  356.  This was needed because the new 2.00.1 (or 2.01 BETA) appearantly has
  357.  a bug that returns un incorrect size for extented attributes when using
  358.  DosQueryPathInfo.
  359.  Appearantly this same bug appears to be in the Novell Netware Requester,
  360.  since I havnt seen the problem mentioned above after I made the changes.
  361.  
  362. - Known problems: ICON.EXE terminates or causes your desktop to hang
  363.          when starting in WINOS/2 Program
  364.          in the early 2.00.1 BETA version. It works properly in GA version.
  365.  
  366. Updates in version 1.6:
  367.  
  368. - Icon.exe now works properly after the service pack (October 1992) has
  369.  been installed!.
  370.  
  371.  
  372. Updates in version 1.61:
  373.  
  374. - ICON.EXE allows the user to specify a directory where extracted icons
  375.  will be placed. (open->settings)
  376.  
  377. - ICON.EXE now works properly with OS/2 2.1 BETA. (Released december '92)
  378.