home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / gfoldr.zip / GFOLDER.HLP (.txt) < prev    next >
OS/2 Help File  |  1995-07-24  |  17KB  |  469 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Using Your Group Folder ΓòÉΓòÉΓòÉ
  3.  
  4. To put objects in your new folder, just drag and drop a file on the folder 
  5. icon. The file is then placed in the folder as is normally done with folders. 
  6.  
  7. When you open the folder at a later time, it appears in the group named Other. 
  8. You can put objects in a folder and associate them with a group at the same 
  9. time by dropping the objects on the one of the groups shown in the Groups pane 
  10. or associate them with the currently open group by dropping them on the 
  11. Contents pane. 
  12.  
  13. You can create new groups by selecting Create group from the group pop-up menu 
  14. or Folder pulldown menu. You can rename a group using direct edit (Shift+F9 or 
  15. Alt+Mouse Button 1). Also, you can reorder the groups by dragging one or more 
  16. groups towards the top or bottom of the Groups list. 
  17.  
  18. Related information: 
  19.  
  20. o Creating standard groups 
  21. o Why use Group Folder? 
  22. o What is the Groups pane on the left? 
  23. o What is the Contents pane on the right? 
  24. o What is the Other group? 
  25.  
  26.  
  27. ΓòÉΓòÉΓòÉ 2. Why use Group Folder? ΓòÉΓòÉΓòÉ
  28.  
  29. To handle the problem of getting to an object in a folder, many users create a 
  30. special folder to hold objects that they frequently use. But often this new 
  31. folder becomes filled with objects, some of which are only used once a month 
  32. while others are used hourly. Locating a desired object in such a folder can be 
  33. like trying to find "a needle in a haystack". 
  34.  
  35. To solve this retrieval problem, Group Folder allows you to create visible 
  36. subsections within a given folder. Thus, you have more control over the 
  37. organization of the contents of folders. The grouping of related objects helps 
  38. you locate the object you want more quickly. 
  39.  
  40. To see how the Group View can be used to organize a collection of objects in a 
  41. folder, select Create standard groups from the menu bar and an example set of 
  42. groups based on the objects installed with OS/2 will be created. 
  43.  
  44. Related information: 
  45.  
  46. o Creating standard groups 
  47. o Installing Group Folder 
  48.  
  49.  
  50. ΓòÉΓòÉΓòÉ 3. Installing Group Folder ΓòÉΓòÉΓòÉ
  51.  
  52. Start the installation program, GFINST.EXE.  It will prompt you for the path 
  53. where you would like GFOLDER.DLL and GFOLDER.HLP copied. When the installation 
  54. is complete, a new folder object called "Group Folder" will appear on your 
  55. desktop. 
  56.  
  57. Note:  GFINST.EXE, GFOLDER.DLL, GFOLDER.HLP should be on the same directory 
  58. before starting installation. 
  59.  
  60.  
  61. ΓòÉΓòÉΓòÉ 4. Help for Group View ΓòÉΓòÉΓòÉ
  62.  
  63. Group View is an alternative way of viewing the contents of a folder.  It 
  64. allows you to associate the objects within a folder with different groups for 
  65. quicker access. 
  66.  
  67. Related information: 
  68.  
  69. o Why use Group Folder? 
  70. o Groups pane 
  71. o Contents pane 
  72.  
  73.  
  74. ΓòÉΓòÉΓòÉ 5. Help for 'Other' Group ΓòÉΓòÉΓòÉ
  75.  
  76. The group named Other is like other groups.  In addition, it has several other 
  77. properties: 
  78.  
  79.  1. Objects not specifically added to a group in the Group Folder are added to 
  80.     the Other group.  For example, if you drop an object on the Group Folder 
  81.     icon, it is automatically added to the Other group. Objects copied to an 
  82.     open view of the Group Folder other than Group View are also added to the 
  83.     Other group. 
  84.  
  85.  2. When a group is deleted the group's associated objects are automatically 
  86.     added to the Other group's list of associated objects. 
  87.  
  88.  3. The Other group cannot be deleted. 
  89.  
  90. All objects within the Group Folder that are not explicitly associated with a 
  91. group are automatically added to the Other group's list of associated objects. 
  92.  
  93. Related information: 
  94.  
  95. o Deleting groups 
  96. o What is a Group View? 
  97.  
  98.  
  99. ΓòÉΓòÉΓòÉ 6. Help for Groups Pane (Left) ΓòÉΓòÉΓòÉ
  100.  
  101. The Groups pane shows the list of groups for the Group Folder. Each group can 
  102. have objects associated with it. Like paper clips used to group related pieces 
  103. of paper in a folder, groups collect related objects. For example: 
  104.  
  105. Games 
  106.  
  107. Objects within the Group Folder associated with the Games group show in the 
  108. Contents pane by double-clicking on the group with mouse button 1 or by 
  109. selecting View contents from a group's pop-up menu.  The icon of the group 
  110. who's associated objects are shown in the Contents pane is "hashed", for 
  111. example: 
  112.  
  113. Games 
  114.  
  115. Menu choices: 
  116.  
  117. o View contents 
  118. o Create group 
  119. o Delete 
  120. o Selected contents 
  121.  
  122. Related information: 
  123.  
  124. o Contents pane 
  125. o Creating standard groups 
  126. o Changing default mouse mappings 
  127.  
  128.  
  129. ΓòÉΓòÉΓòÉ 7. Help for Contents Pane (Right) ΓòÉΓòÉΓòÉ
  130.  
  131. The right pane shows the objects that have been associated with the group that 
  132. is open in the Groups left pane. The open group is indicated by the "hash" 
  133. marks behind the group icon. 
  134.  
  135. The contents of a a group is shown in the Contents pane by double-clicking with 
  136. mouse button 1 on a group or selecting View contents from the group pop-up 
  137. menu. 
  138.  
  139. Related information: 
  140.  
  141. o Groups pane 
  142. o View contents 
  143. o Changing the list of objects associated with a group 
  144. o Changing default mouse mappings 
  145.  
  146.  
  147. ΓòÉΓòÉΓòÉ 8. Help for Create Group ΓòÉΓòÉΓòÉ
  148.  
  149. This choice creates another group.  To change the name of the group, use direct 
  150. edit (Shift+F9 or Alt+Mouse Button 1). 
  151.  
  152.  
  153. ΓòÉΓòÉΓòÉ 9. Help for Delete (Group) ΓòÉΓòÉΓòÉ
  154.  
  155. This choice deletes the group.  The objects that were associated with the 
  156. deleted group are added to the Other group's list of associated objects. 
  157.  
  158. Related information: 
  159.  
  160. o What is the Other group? 
  161.  
  162.  
  163. ΓòÉΓòÉΓòÉ 10. Help for Create Standard Groups ΓòÉΓòÉΓòÉ
  164.  
  165. This choice creates several standard groups and fills each of them with copies 
  166. or shadows of many of the objects shipped with OS/2. These groups organize the 
  167. objects into easily understood categories. If you have never used a Group View 
  168. before, select this choice to see an example of its use. 
  169.  
  170. Note:  All the objects created by the Create standard groups choice are either 
  171.        shadows of existing objects, or copies of existing objects; they can be 
  172.        safely deleted from the Group Folder when you no longer need them. 
  173.  
  174. If you did not install all of OS/2 options, some of the objects above may not 
  175. be created. 
  176.  
  177. The list of groups and objects created when Create standard groups is selected: 
  178.  
  179. Development     Enhanced Editor 
  180.                 Seek and Scan Files 
  181.                 OS/2 Window 
  182.                 OS/2 Full Screen 
  183.                 Command Reference 
  184.                 Icon Editor 
  185.  
  186. Games           Solitaire - Klondike 
  187.                 Reversi 
  188.                 OS/2 Chess 
  189.                 Games folder (shadow) 
  190.  
  191. System          OS/2 System folder (shadow) 
  192.                 Startup folder (shadow) 
  193.                 System (shadow) 
  194.  
  195. Palettes        Color Palette 
  196.                 Font Palette 
  197.                 Scheme Palette 
  198.  
  199. Misc            Templates folder (shadow) 
  200.                 Minimized Window Viewer (shadow) 
  201.                 Shredder (shadow) 
  202.                 Drives folder (shadow) 
  203.                 Desktop (shadow) 
  204.  
  205. Help            Master Help Index 
  206.                 Information folder (shadow) 
  207.                 Start Here 
  208.                 Glossary 
  209.  
  210.  
  211. ΓòÉΓòÉΓòÉ 11. Product Information ΓòÉΓòÉΓòÉ
  212.  
  213. Copyright (C), IBM Corporation 1993, 1994, 1995 
  214.  
  215. Group View is an alternative view of folder contents written by Dan Kehn 
  216. (Internet ID kehn@vnet.ibm.com). 
  217.  
  218. Related information: 
  219.  
  220. o Why use Group Folder? 
  221.  
  222. OS/2, Warp, and LaunchPad are trademarks of IBM Corporation. 
  223.  
  224.  
  225. ΓòÉΓòÉΓòÉ 12. Help for View contents ΓòÉΓòÉΓòÉ
  226.  
  227. This choice displays the objects associated with the chosen group in the 
  228. Contents pane. Select this choice or double-click a group with mouse button 1. 
  229.  
  230. Note:  The objects associated with only one group can be shown in the Contents 
  231. pane at any given time. 
  232.  
  233. Related information: 
  234.  
  235. o Groups pane 
  236. o Contents pane 
  237. o Changing default mouse mappings 
  238.  
  239.  
  240. ΓòÉΓòÉΓòÉ 13. Help for Selected Contents ΓòÉΓòÉΓòÉ
  241.  
  242. This category of choices is primarily intended for keyboard users.  It allows 
  243. the objects selected in the Contents pane to be associated with another group, 
  244. copied and the copies associated with another group, or shadowed and the 
  245. shadows associated with another group. 
  246.  
  247. Content selection choices: 
  248.  
  249. o Change group 
  250. o Add to group 
  251. o Remove from group 
  252. o Copy 
  253. o Create shadow 
  254.  
  255. Related information: 
  256.  
  257. o What is the Groups pane on the left? 
  258. o What is the Contents pane on the right? 
  259.  
  260.  
  261. ΓòÉΓòÉΓòÉ 14. Help for Change Group (Selected Contents) ΓòÉΓòÉΓòÉ
  262.  
  263. The Change group choice is primarily intended for keyboard users.  It allows 
  264. you to associated the objects selected in the Contents pane with another group. 
  265.  
  266. Select this choice or drag one or more objects shown in the Contents pane to 
  267. one of the groups shown in the Groups pane. 
  268.  
  269. Related information: 
  270.  
  271. o Selected contents 
  272.  
  273.  
  274. ΓòÉΓòÉΓòÉ 15. Help for Add to Group (Selected Contents) ΓòÉΓòÉΓòÉ
  275.  
  276. The Add to group choice allows the objects selected in the Contents pane to be 
  277. added to another group.  It allows you to associate an object in the Contents 
  278. pane with one or more groups. 
  279.  
  280. Note:  An object can be associated with more than one group, but can only be 
  281. associated with the same group once. 
  282.  
  283. Related information: 
  284.  
  285. o Selected contents 
  286.  
  287.  
  288. ΓòÉΓòÉΓòÉ 16. Help for Remove from Group (Selected Contents) ΓòÉΓòÉΓòÉ
  289.  
  290. The Remove from group choice allows the objects selected in the Contents pane 
  291. to be removed from a group. 
  292.  
  293. Note:  A contained object is always associated with at least one group.  If an 
  294. object's last association is deleted, a new association is automatically added 
  295. to the Other group. 
  296.  
  297. Related information: 
  298.  
  299. o Selected contents 
  300. o What is the Other group? 
  301.  
  302.  
  303. ΓòÉΓòÉΓòÉ 17. Help for Copy (Selected Contents) ΓòÉΓòÉΓòÉ
  304.  
  305. The Copy choice is primarily intended for keyboard users.  It allows you to 
  306. copy and then associate the objects selected in the Contents pane with another 
  307. group. 
  308.  
  309. Select this choice or drag one or more objects shown in the Contents pane to 
  310. one of the groups shown in the Groups pane.  For example, an object shown in 
  311. the Contents pane on the right can be copied then associated with a different 
  312. group by dragging it (while holding the Ctrl key) to one of the groups shown in 
  313. the Groups pane on the left. 
  314.  
  315. Related information: 
  316.  
  317. o Selected contents 
  318. o View contents 
  319.  
  320.  
  321. ΓòÉΓòÉΓòÉ 18. Help for Create Shadow (Selected Contents) ΓòÉΓòÉΓòÉ
  322.  
  323. The Create shadow choice is primarily intended for keyboard users.  It allows 
  324. you to create shadows and then associate the objects selected in the Contents 
  325. pane with another group. 
  326.  
  327. The same result can be accomplished by dragging one or more objects shown in 
  328. the Contents pane to one of the groups shown in the Groups pane.  For example, 
  329. a shadow can be created for an object shown in the Contents pane on the right 
  330. then associated with a different group by dragging it (while holding the Ctrl 
  331. and Shift keys) to one of the groups shown in the Groups pane on the left. 
  332.  
  333. Related information: 
  334.  
  335. o Selected contents 
  336. o View contents 
  337.  
  338.  
  339. ΓòÉΓòÉΓòÉ 19. Help for Folder (menu bar) ΓòÉΓòÉΓòÉ
  340.  
  341. Choose the Folder menu bar choice to display a pulldown menu containing choices 
  342. affecting the folder as a whole.  More specific help can be requested from the 
  343. individual pulldown menu choices. 
  344.  
  345. Related information: 
  346.  
  347. o Create standard groups 
  348. o Create group 
  349.  
  350.  
  351. ΓòÉΓòÉΓòÉ 20. Help for View (menu bar) ΓòÉΓòÉΓòÉ
  352.  
  353. Choose the View menu bar choice to show a pulldown menu containing choices 
  354. affecting the presentation of the Group View. 
  355.  
  356. The Sort groups choice sorts the groups alphabetically. 
  357.  
  358. The Sort contents choice sorts the objects in the currently shown group 
  359. alphabetically. 
  360.  
  361. The Hide on open choice, if checked, will result in the Group View being hidden 
  362. when you open an object shown in the Group View by double-clicking it or by 
  363. choosing Enter. 
  364.  
  365. By default, a group is opened by double-clicking it and an object is opened by 
  366. double-clicking it.  If check Open on single-click is checked, groups and 
  367. objects will be opened by a single click, similar to the OS/2 Warp LaunchPad. 
  368. You can select groups and objects without opening them by using Ctrl+Mouse 
  369. Button 1 or Shift+Mouse Button 1. 
  370.  
  371.  
  372. ΓòÉΓòÉΓòÉ 21. Help for Selected (menu bar) ΓòÉΓòÉΓòÉ
  373.  
  374. Choose the Selected menu bar choice to display a pulldown menu containing 
  375. choices affecting the currently selected objects in the pane that last had the 
  376. location cursor, either the Contents pane or Groups pane. 
  377.  
  378. Related information: 
  379.  
  380. o What is the Groups pane on the left? 
  381. o What is the Contents pane on the right? 
  382.  
  383.  
  384. ΓòÉΓòÉΓòÉ 22. Programming API for Group Folder ΓòÉΓòÉΓòÉ
  385.  
  386. The Group Folder supports Workplace Shell setup strings.  These strings can be 
  387. passed to a Group Folder to create groups and objects within the groups. 
  388. Generally this is done as part of a customized Group Folder installation.  See 
  389. GFOLDER.CMD, included with this package, for an example. 
  390.  
  391. NEWGROUP=           Title of group to create. 
  392.  
  393. CREATEOBJECT=       New object title. 
  394.  
  395. CLASS=              Class of new object. 
  396.  
  397. IFEXISTS=           Action to take if an object with the same title already 
  398.                     exists in the Group Folder.  Valid values are FAIL, UPDATE, 
  399.                     or REPLACE. 
  400.  
  401. INGROUP=            Title of  the group to place the new object in.  If 
  402.                     unspecified, the new object is placed in the Other group. 
  403.  
  404. The setup string below would create a program in group "Productivity Programs": 
  405.  
  406.  NEWGROUP=Productivity Programs;
  407.  CREATEOBJECT=Enhanced Editor;
  408.  CLASS=WPProgram;
  409.  IFEXISTS=REPLACE;
  410.  INGROUP=Productivity Programs;
  411.  EXENAME=?:\OS2\APPS\EPM.EXE;
  412.  PROGTYPE=PM
  413.  
  414. This setup string can be passed to the Group Folder using the WinSetObjectData 
  415. API, the REXX SysSetObjectData, or the Workplace Shell wpSetup method.  The 
  416. Group Folder creates an instance of the class specified in the CLASS keyword 
  417. and passes it the entire setup string passed to the Group Folder including the 
  418. NEWGROUP, CREATEOBJECT, CLASS, and INGROUP keywords (which should be ignored by 
  419. the newly created instance). 
  420.  
  421. Note:  Only one object can be created per setup invocation because the 
  422. NEWGROUP, CREATEOBJECT, CLASS, IFEXISTS, and INGROUP keywords can only be 
  423. specified once in the setup string. 
  424.  
  425. Other Group Folder setup strings: 
  426.  
  427. QUERYGROUPCONTENT   Returns the Group Folder contents (gfx) into a named shared 
  428.                     memory object: 
  429.  
  430.                                         typedef struct // gfg
  431.                                         {
  432.                                           PSZ pszTitle;         // group title
  433.                                           ULONG cObjects;       // number of objects in group
  434.                                           HOBJECT *phObject;    // pointer to array of object handles
  435.                                         } GFGROUP, *PGFGROUP;
  436.  
  437.                                         typedef struct // gfx
  438.                                         {
  439.                                           ULONG cb;             // size of entire export buffer
  440.                                           ULONG cgfg;           // number of groups
  441.                                           GFGROUP gfg[1];       // array of groups
  442.                                         } GFEXPORT, *PGFEXPORT;
  443.  
  444. QUERYGROUPCONTENTLENGTH Returns the length of the Group Folder contents into a 
  445.                     named shared memory object. 
  446.  
  447. RENAMEDEFAULTGROUP= Rename the default group. 
  448.  
  449. VIEWGROUP=          Display the objects in the named group. 
  450.  
  451. Group Folder setup strings whose parameter value is the object handle in 
  452. hexidecimal followed by the group name. For example: 
  453.  
  454. ADDOBJECTHANDLETOGROUP=2F03A,Games;
  455.  
  456. Note:  The object handle must belong to an object already existing in the Group 
  457. Folder. 
  458.  
  459. ADDOBJECTHANDLETOGROUP= Adds the object with the specified handle to the named 
  460.                     group. After this operation, the object may be referenced 
  461.                     by more than one group. 
  462.  
  463. MOVEOBJECTHANDLETOGROUP= Moves the object with the specified handle to the 
  464.                     named group. After this operation, the object is referenced 
  465.                     by only one group. 
  466.  
  467. REMOVEOBJECTHANDLEFROMGROUP= Removes the object with the specified handle from 
  468.                     the named group only if it is in more than one group. 
  469.