home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / hwicb.zip / HWICLASS.DAT / HWICLASS.HLP (.txt) < prev    next >
OS/2 Help File  |  1997-05-04  |  14KB  |  530 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Application - ClassBrowser ΓòÉΓòÉΓòÉ
  3.  
  4. This Presentation Manager based ClassBrowser allows all actions related to the 
  5. SOM/WPS model of IBM. It doesn't need to be registered in the SOM/WPS class 
  6. model itself because it's an EXE based application. 
  7.  
  8. Please take care before using these actions. Please take a backup of your 
  9. system before using the more complicated actions. This is true for "Move 
  10. Class". 
  11.  
  12.  
  13. ΓòÉΓòÉΓòÉ 2. Disclaimer ΓòÉΓòÉΓòÉ
  14.  
  15. This product is supplied with no warranty, either expressed or implied. The 
  16. author Harald Wilhelm will not accept responsibility for any adverse 
  17. consequences that may arise from the use or misuse of ClassBrowser or its 
  18. associated program and data files. Such adverse consequences include, but are 
  19. not limited to, loss of profit, and loss of data. 
  20.  
  21. The author specifically disclaims all warranties, expressed or implied, 
  22. including but not limited to, any implied warranty of merchantability or 
  23. fitness for a particular purpose. 
  24.  
  25.  
  26. ΓòÉΓòÉΓòÉ 3. Copyright ΓòÉΓòÉΓòÉ
  27.  
  28. ClassBrowser is Copyright 1995 Harald Wilhelm. 
  29.  
  30. ClassBrowser exists in evaluation and licensed versions. The product 
  31. information dialog specifies the type of each copy. 
  32.  
  33. Evaluation copies of ClassBrowser are supplied for evaluation only. You may 
  34. distribute them freely, but they are not to be used commercially. After 21 days 
  35. of evaluation, you must cease using ClassBrowser unless you register it. 
  36.  
  37. Licensed copies of ClassBrowser may be used commerically, but not freely 
  38. distributed. Only one instance of each licensed copy may be used at any 
  39. particular time. 
  40.  
  41. The copyright of ClassBrowser is currently held by the author Harald Wilhelm. 
  42.  
  43.  
  44. ΓòÉΓòÉΓòÉ 4. Licensing ClassBrowser ΓòÉΓòÉΓòÉ
  45.  
  46. ClassBrowser is useful to almost the entire OS/2 community. It is particularly 
  47. attractive to software engineers who need to build SOM/WPS classes. By bundling 
  48. ClassBrowser with your software development system you could give your product 
  49. the competitive edge. 
  50.  
  51. The author invites you to license ClassBrowser under negotiable terms. To 
  52. contact the author, see Contacting the author. 
  53.  
  54. Alternatively, see How to register if you simply wish to continue using 
  55. ClassBrowser. 
  56.  
  57.  
  58. ΓòÉΓòÉΓòÉ 5. How to register ΓòÉΓòÉΓòÉ
  59.  
  60. ClassBrowser is shareware. This means that you can use the program for a 
  61. limited time (21 days) before you decide whether you want to keep it. If you 
  62. want to continue using ClassBrowser after that time you are expected to 
  63. register it. The registered version (which you will be sent when you register) 
  64. is more uptodate, removes the sticky windows, but is otherwise identical to (or 
  65. better than) the evaluation version. 
  66.  
  67. Once you have registered, technical support is available from the author via 
  68. e-mail or mail. Voice support is not provided. 
  69.  
  70. Please see the file ORDER.TXT for order information. 
  71.  
  72.  
  73. ΓòÉΓòÉΓòÉ 6. Contacting the author ΓòÉΓòÉΓòÉ
  74.  
  75. You may register a single copy of ClassBrowser or initiate licensing 
  76. negotiations with the author. You can contact him at the address below: 
  77.  
  78. Fax: 
  79.  
  80.    +49 (0) 22 1  5 90 91 99
  81.  
  82. Mail: 
  83.  
  84.    Harald Wilhelm
  85.    Am Scheidweg 60
  86.    D-50765 Koeln (Cologne)
  87.    Germany
  88.  
  89. E-Mail: 
  90.  
  91.    Harald_Wilhelm@hawi.de
  92.  
  93.  
  94. ΓòÉΓòÉΓòÉ 7. Actionbar Choices ΓòÉΓòÉΓòÉ
  95.  
  96.  
  97. ΓòÉΓòÉΓòÉ 7.1. Actionbar Choice - Class ΓòÉΓòÉΓòÉ
  98.  
  99.  
  100. ΓòÉΓòÉΓòÉ 7.1.1. Pulldown Choice - Register ΓòÉΓòÉΓòÉ
  101.  
  102. Activating this action will bring up the dialog Register Class. 
  103.  
  104.  
  105. ΓòÉΓòÉΓòÉ 7.1.2. Pulldown Choice - Deregister ΓòÉΓòÉΓòÉ
  106.  
  107. After a security message you can deregister an existing class after pressing 
  108. this option. Please be careful and don't deregister system classes. Please use 
  109. this option with classes of your own only. 
  110.  
  111.  
  112. ΓòÉΓòÉΓòÉ 7.1.3. Pulldown Choice - Replace ΓòÉΓòÉΓòÉ
  113.  
  114. Activating this action will bring up the dialog Replace Class. 
  115.  
  116.  
  117. ΓòÉΓòÉΓòÉ 7.1.4. Pulldown Choice - Move ΓòÉΓòÉΓòÉ
  118.  
  119. Activating this action will bring up the dialog Move Class. 
  120.  
  121.  
  122. ΓòÉΓòÉΓòÉ 7.1.5. Pulldown Choice - Dump ΓòÉΓòÉΓòÉ
  123.  
  124. This option will dump the entire class definition hierarchie to the file 
  125. HWICLASS.DMP. 
  126.  
  127.  
  128. ΓòÉΓòÉΓòÉ 7.2. Actionbar Choice - Module ΓòÉΓòÉΓòÉ
  129.  
  130.  
  131. ΓòÉΓòÉΓòÉ 7.2.1. Pulldown Choice - Replace ΓòÉΓòÉΓòÉ
  132.  
  133. Activating this action will bring up the dialog Replace Module. 
  134.  
  135.  
  136. ΓòÉΓòÉΓòÉ 7.3. Actionbar Choice - Instance ΓòÉΓòÉΓòÉ
  137.  
  138.  
  139. ΓòÉΓòÉΓòÉ 7.3.1. Pulldown Choice - Create ΓòÉΓòÉΓòÉ
  140.  
  141. Activating this action will bring up the dialog Create Instance. 
  142.  
  143.  
  144. ΓòÉΓòÉΓòÉ 7.4. Actionbar Choice - Help ΓòÉΓòÉΓòÉ
  145.  
  146.  
  147. ΓòÉΓòÉΓòÉ 7.4.1. Pulldown Choice - General Help ΓòÉΓòÉΓòÉ
  148.  
  149. Shows General help. 
  150.  
  151.  
  152. ΓòÉΓòÉΓòÉ 7.4.2. Pulldown Choice - About ΓòÉΓòÉΓòÉ
  153.  
  154. Shows the Aboutbox. 
  155.  
  156.  
  157. ΓòÉΓòÉΓòÉ 7.4.3. Pulldown Choice - Register ΓòÉΓòÉΓòÉ
  158.  
  159. This choice is only available, if this product is not registered. Activating 
  160. this action will bring up the dialog Register Shareware. 
  161.  
  162.  
  163. ΓòÉΓòÉΓòÉ 8. Container ΓòÉΓòÉΓòÉ
  164.  
  165. The container does contain all the neccessary class related information. 
  166.  
  167.  
  168. ΓòÉΓòÉΓòÉ 8.1. Class ΓòÉΓòÉΓòÉ
  169.  
  170. This column shows the names of all class registered currently in SOM/WPS. This 
  171. list is ordered with the first class registered at top position. 
  172.  
  173.  
  174. ΓòÉΓòÉΓòÉ 8.2. Filename ΓòÉΓòÉΓòÉ
  175.  
  176. This column shows the modulname of a registered class. It's possible to 
  177. register a class without a filename. This is important if you want to predefine 
  178. a class that will come to life when the corresponding file is copied to the 
  179. system. 
  180.  
  181.  
  182. ΓòÉΓòÉΓòÉ 8.3. Size ΓòÉΓòÉΓòÉ
  183.  
  184. If the registered class has a corresponding module, the size of that file is 
  185. reported here. 
  186.  
  187.  
  188. ΓòÉΓòÉΓòÉ 8.4. Date ΓòÉΓòÉΓòÉ
  189.  
  190. If the registered class has a corresponding module, the date of that file is 
  191. reported here. 
  192.  
  193.  
  194. ΓòÉΓòÉΓòÉ 8.5. Time ΓòÉΓòÉΓòÉ
  195.  
  196. If the registered class has a corresponding module, the time of that file is 
  197. reported here. 
  198.  
  199.  
  200. ΓòÉΓòÉΓòÉ 8.6. References ΓòÉΓòÉΓòÉ
  201.  
  202. This column shows how many modules (EXE or DLL) have this module in-use. You 
  203. can only replace a module if it's in-use count is 0. ClassBrowser uses the 
  204. undocumented API DosQProcStatus to query this information. 
  205.  
  206.  
  207. ΓòÉΓòÉΓòÉ 9. Dialogs ΓòÉΓòÉΓòÉ
  208.  
  209.  
  210. ΓòÉΓòÉΓòÉ 9.1. Dialog - Register Class ΓòÉΓòÉΓòÉ
  211.  
  212. This dialog allows to register a new SOM/WPS class. 
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ 9.1.1. Entryfield - Classname ΓòÉΓòÉΓòÉ
  216.  
  217. This is the name of object class you want to add to the Workplace. Type the 
  218. class name exactly as it is built, case sensitive. 
  219.  
  220.  
  221. ΓòÉΓòÉΓòÉ 9.1.2. Entryfield - Filename ΓòÉΓòÉΓòÉ
  222.  
  223. Add a full qualified filename or an unqualified filename (without drive, 
  224. directory and the extension DLL) if the LIBPATH does include the location of 
  225. this module. This DLL must have been created by the IBM System Object Model 
  226. (SOM). 
  227.  
  228. The author always recommends to use the unqualified method, because it's much 
  229. more easier to replace or move an existing class to a different location then. 
  230.  
  231.  
  232. ΓòÉΓòÉΓòÉ 9.1.3. Pushbutton - Search ΓòÉΓòÉΓòÉ
  233.  
  234. This pushbutton starts the Open Filedialog to search for a classmodule in a 
  235. comfortable manner. After this module is found, it's name will be placed into 
  236. the corresponding entryfield. 
  237.  
  238.  
  239. ΓòÉΓòÉΓòÉ 9.1.4. Pushbutton - Ok ΓòÉΓòÉΓòÉ
  240.  
  241. Starts the desired action. 
  242.  
  243.  
  244. ΓòÉΓòÉΓòÉ 9.1.5. Pushbutton - Help ΓòÉΓòÉΓòÉ
  245.  
  246. Shows help for the selected dialog element. 
  247.  
  248.  
  249. ΓòÉΓòÉΓòÉ 9.2. Dialog - Replace Class ΓòÉΓòÉΓòÉ
  250.  
  251. This dialog allows to replace and unreplace an already registered SOM/WPS class 
  252. by another SOM/WPS class. 
  253.  
  254. When replacing the class, the replacement class must be a descendant of the 
  255. original class. 
  256.  
  257.  
  258. ΓòÉΓòÉΓòÉ 9.2.1. Entryfield - New Classname ΓòÉΓòÉΓòÉ
  259.  
  260. Enter the classname that will replace the original classname. 
  261.  
  262. The replacement class must be a descendant of the original class. Replacing an 
  263. object class is useful for modifying the behavior of objects which are 
  264. instances of the original class but are not aware of the replacement class. 
  265.  
  266.  
  267. ΓòÉΓòÉΓòÉ 9.2.2. Checkbox - Unreplace ΓòÉΓòÉΓòÉ
  268.  
  269. If this checkbox is selected the class will return to it's original state. The 
  270. replacement class will be ignored. 
  271.  
  272.  
  273. ΓòÉΓòÉΓòÉ 9.2.3. Pushbutton - Ok ΓòÉΓòÉΓòÉ
  274.  
  275. Starts the desired action. 
  276.  
  277.  
  278. ΓòÉΓòÉΓòÉ 9.2.4. Pushbutton - Help ΓòÉΓòÉΓòÉ
  279.  
  280. Shows help for the selected dialog element. 
  281.  
  282.  
  283. ΓòÉΓòÉΓòÉ 9.3. Dialog - Move Class ΓòÉΓòÉΓòÉ
  284.  
  285. This dialogs allows to move the module of an already registered SOM/WPS class 
  286. to a different location. After successful completion the class will always use 
  287. the new location to access the module. 
  288.  
  289. Please shutdown after successful completion. 
  290.  
  291. Please make a backup copy of your current system before using that option. 
  292. Sometimes this action will not bring success. There are some differences 
  293. between using SOM-1 (OS/2 vs2.11) and SOM-2 (OS/2 Warp 3). 
  294.  
  295.  
  296. ΓòÉΓòÉΓòÉ 9.3.1. Entryfield - New Filename ΓòÉΓòÉΓòÉ
  297.  
  298. Add a full qualified filename or an unqualified filename (without drive, 
  299. directory and the extension DLL) if the LIBPATH does include the location of 
  300. this module. This DLL must have been created by the IBM System Object Model 
  301. (SOM). 
  302.  
  303. The author always recommends to use the unqualified method, because it's much 
  304. more easier to replace or move an existing class to a different location then. 
  305.  
  306. The current class will be replaced by the same class in a new file. This is 
  307. useful when changing the location of a full qualified filename of a class. 
  308.  
  309. Please make a backup copy of your current system before using that option. 
  310. Sometimes this action will not bring success. There are some differences 
  311. between using SOM-1 (OS/2 vs2.11) and SOM-2 (OS/2 Warp 3). 
  312.  
  313.  
  314. ΓòÉΓòÉΓòÉ 9.3.2. Pushbutton - Search ΓòÉΓòÉΓòÉ
  315.  
  316. This pushbutton starts the Open Filedialog to search for a classmodule in a 
  317. comfortable manner. After this module is found, it's name will be placed into 
  318. the corresponding entryfield. 
  319.  
  320.  
  321. ΓòÉΓòÉΓòÉ 9.3.3. Pushbutton - Ok ΓòÉΓòÉΓòÉ
  322.  
  323. Starts the desired action. 
  324.  
  325.  
  326. ΓòÉΓòÉΓòÉ 9.3.4. Pushbutton - Help ΓòÉΓòÉΓòÉ
  327.  
  328. Shows help for the selected dialog element. 
  329.  
  330.  
  331. ΓòÉΓòÉΓòÉ 9.4. Dialog - Replace Modul ΓòÉΓòÉΓòÉ
  332.  
  333. This dialog allows to replace a module of an already registered SOM/WPS class 
  334. with a new module. After successful completion the new module will replace the 
  335. old module. 
  336.  
  337. Please shutdown after successful completion. 
  338.  
  339.  
  340. ΓòÉΓòÉΓòÉ 9.4.1. Entryfield - New Filename ΓòÉΓòÉΓòÉ
  341.  
  342. Add a full qualified filename or an unqualified filename (without drive, 
  343. directory and the extension DLL) if the LIBPATH does include the location of 
  344. this module. This DLL must have been created by the IBM System Object Model 
  345. (SOM). 
  346.  
  347. The author always recommends to use the unqualified method, because it's much 
  348. more easier to replace or move an existing class to a different location then. 
  349.  
  350. The current module will be loaded into the SWAPPER.DAT and free the DLL. The 
  351. new file will replace the current DLL. If the DLL access count drops to 0 the 
  352. next access will take the new file. If the current DLL is in use all the time, 
  353. you'll need to reboot to take the new file into account. 
  354.  
  355.  
  356. ΓòÉΓòÉΓòÉ 9.4.2. Pushbutton - Search ΓòÉΓòÉΓòÉ
  357.  
  358. This pushbutton starts the Open Filedialog to search for a classmodule in a 
  359. comfortable manner. After this module is found, it's name will be placed into 
  360. the corresponding entryfield. 
  361.  
  362.  
  363. ΓòÉΓòÉΓòÉ 9.4.3. Pushbutton - Ok ΓòÉΓòÉΓòÉ
  364.  
  365. Starts the desired action. 
  366.  
  367.  
  368. ΓòÉΓòÉΓòÉ 9.4.4. Pushbutton - Help ΓòÉΓòÉΓòÉ
  369.  
  370. Shows help for the selected dialog element. 
  371.  
  372.  
  373. ΓòÉΓòÉΓòÉ 9.5. Dialog - Create Instance ΓòÉΓòÉΓòÉ
  374.  
  375. This dialog allows to create an instance of an already registered SOM/WPS 
  376. class. 
  377.  
  378.  
  379. ΓòÉΓòÉΓòÉ 9.5.1. Entryfield - Title ΓòÉΓòÉΓòÉ
  380.  
  381. This is the text string you assign the object. The text string becomes the 
  382. object title and appears under the object when the object is displayed on the 
  383. Workplace Shell. When the object is in an opened state, the text string appears 
  384. in the title bar of the window. 
  385.  
  386.  
  387. ΓòÉΓòÉΓòÉ 9.5.2. Entryfield - Object-ID ΓòÉΓòÉΓòÉ
  388.  
  389. You can assign an object-id to every object. You don't need this really, but it 
  390. may help sometimes if this object is a folder for other objects too. 
  391.  
  392.  
  393. ΓòÉΓòÉΓòÉ 9.5.3. Combobox - Folder ΓòÉΓòÉΓòÉ
  394.  
  395. In this entryfield you can enter a complete filename (e.g. D:\DIR\MY.DLL) or 
  396. you can select one of this predefined values from the combobox list. 
  397.  
  398.  
  399. ΓòÉΓòÉΓòÉ 9.5.4. Entryfield - Setup ΓòÉΓòÉΓòÉ
  400.  
  401. This is a series of keyname=value pairs (separated by semicolons) that change 
  402. the behavior of the object. Each object class defines the keynames and 
  403. parameters it expects to see. All parameters have safe defaults, so it is never 
  404. required to pass parameters to an object. 
  405.  
  406.  
  407. ΓòÉΓòÉΓòÉ 9.5.5. Pushbutton - Setup ΓòÉΓòÉΓòÉ
  408.  
  409. This pushbutton will load the dialog Setup. This additional dialog allows to 
  410. select setup strings in a very comfortable manner. 
  411.  
  412.  
  413. ΓòÉΓòÉΓòÉ 9.5.6. Pushbutton - Ok ΓòÉΓòÉΓòÉ
  414.  
  415. Starts the desired action. 
  416.  
  417.  
  418. ΓòÉΓòÉΓòÉ 9.5.7. Pushbutton - Help ΓòÉΓòÉΓòÉ
  419.  
  420. Shows help for the selected dialog element. 
  421.  
  422.  
  423. ΓòÉΓòÉΓòÉ 9.6. Dialog - Setup ΓòÉΓòÉΓòÉ
  424.  
  425. This dialog allows to select predefined setup strings. 
  426.  
  427.  
  428. ΓòÉΓòÉΓòÉ 9.6.1. Listbox - Setup Strings ΓòÉΓòÉΓòÉ
  429.  
  430. This listbox holds all the current setup strings for all known objects. You can 
  431. select all setup options you need within one step and hit the pushbutton Ok. 
  432. The selected setup strings will be placed into the setup entryfield on the 
  433. parent dialog, seperated by semicolons. 
  434.  
  435. If the author forgot a setup string please let him know. 
  436.  
  437.  
  438. ΓòÉΓòÉΓòÉ 9.6.2. Pushbutton - Ok ΓòÉΓòÉΓòÉ
  439.  
  440. Starts the desired action. 
  441.  
  442.  
  443. ΓòÉΓòÉΓòÉ 9.6.3. Pushbutton - Help ΓòÉΓòÉΓòÉ
  444.  
  445. Shows help for the selected dialog element. 
  446.  
  447.  
  448. ΓòÉΓòÉΓòÉ 9.7. Dialog - About ΓòÉΓòÉΓòÉ
  449.  
  450. This dialog will show information to the current application. 
  451.  
  452.  
  453. ΓòÉΓòÉΓòÉ 9.7.1. Pushbutton - Ok ΓòÉΓòÉΓòÉ
  454.  
  455. Activating this pushbutton will leave the current dialog. 
  456.  
  457.  
  458. ΓòÉΓòÉΓòÉ 9.8. Dialog - File Open ΓòÉΓòÉΓòÉ
  459.  
  460. This dialog will be used to search for existing or to create new files. 
  461.  
  462.  
  463. ΓòÉΓòÉΓòÉ 9.8.1. Entryfield - Open filename ΓòÉΓòÉΓòÉ
  464.  
  465. You can enter a full qualified filename or a filename containing global search 
  466. characters in this entryfield. 
  467.  
  468.  
  469. ΓòÉΓòÉΓòÉ 9.8.2. Combobox - Type of file ΓòÉΓòÉΓòÉ
  470.  
  471. This combobox will contain the types of files you are searching for. 
  472.  
  473.  
  474. ΓòÉΓòÉΓòÉ 9.8.3. Combobox - Drive ΓòÉΓòÉΓòÉ
  475.  
  476. Select a drive out of the choice of existing drives. The Listboxes Directory 
  477. and File will be updated immediately. 
  478.  
  479.  
  480. ΓòÉΓòÉΓòÉ 9.8.4. Listbox - File ΓòÉΓòÉΓòÉ
  481.  
  482. Double click on a filename in this listbox to open the selected file. 
  483.  
  484.  
  485. ΓòÉΓòÉΓòÉ 9.8.5. Listbox - Directory ΓòÉΓòÉΓòÉ
  486.  
  487. Double click on a directory in this listbox to change the current search 
  488. location. The listbox File will be updated immediately. 
  489.  
  490.  
  491. ΓòÉΓòÉΓòÉ 9.8.6. Pushbutton - Ok ΓòÉΓòÉΓòÉ
  492.  
  493. Activating this pushbutton will create a new or open an existing file. 
  494.  
  495.  
  496. ΓòÉΓòÉΓòÉ 9.8.7. Pushbutton - Cancel ΓòÉΓòÉΓòÉ
  497.  
  498. Activating this pushbutton will leave the current dialog. 
  499.  
  500.  
  501. ΓòÉΓòÉΓòÉ 9.8.8. Pushbutton - Help ΓòÉΓòÉΓòÉ
  502.  
  503. Shows help for the selected dialog element. 
  504.  
  505.  
  506. ΓòÉΓòÉΓòÉ 9.9. Dialog - Register Shareware ΓòÉΓòÉΓòÉ
  507.  
  508. This dialog is only available if this product is not registered. 
  509.  
  510.  
  511. ΓòÉΓòÉΓòÉ 9.9.1. Entryfield Registername ΓòÉΓòÉΓòÉ
  512.  
  513. Please enter the name you got from the author of this package. 
  514.  
  515.  
  516. ΓòÉΓòÉΓòÉ 9.9.2. Entryfield Registercode ΓòÉΓòÉΓòÉ
  517.  
  518. Please enter the code you got from the author of this package. 
  519.  
  520.  
  521. ΓòÉΓòÉΓòÉ 9.9.3. Pushbutton - Ok ΓòÉΓòÉΓòÉ
  522.  
  523. Starts to register the product. If this action is successfull, the titlebar of 
  524. the application will change. The word "Unregistered" will disappear. This is 
  525. true for the pulldown choice Register too. 
  526.  
  527.  
  528. ΓòÉΓòÉΓòÉ 9.9.4. Pushbutton - Help ΓòÉΓòÉΓòÉ
  529.  
  530. Shows help for the selected dialog element.