home *** CD-ROM | disk | FTP | other *** search
/ Mega Top 1 / os2_top1.zip / os2_top1 / APPS / UTILS / A-G / GFOLDR / GFOLDER.HLP (.txt) < prev    next >
OS/2 Help File  |  1994-03-08  |  16KB  |  463 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. First copy your GFOLDER.DLL file to a disk. For example, C:\OS2\DLL. Also copy 
  53. the Group Folder help file, GFOLDER.HLP, to your help directory, for example, 
  54. C:\OS2\HELP. 
  55.  
  56. Then start the installation program, GFINST.EXE.  It will prompt you for the 
  57. path where your copied the GFOLDER.DLL.  When the installation is complete, a 
  58. new folder object called "Group Folder" will appear on your desktop. 
  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.  
  127.  
  128. ΓòÉΓòÉΓòÉ 7. Help for Contents Pane (Right) ΓòÉΓòÉΓòÉ
  129.  
  130. The right pane shows the objects that have been associated with the group that 
  131. is open in the Groups left pane. The open group is indicated by the "hash" 
  132. marks behind the group icon. 
  133.  
  134. The contents of a a group is shown in the Contents pane by double-clicking with 
  135. mouse button 1 on a group or selecting View contents from the group pop-up 
  136. menu. 
  137.  
  138. Related information: 
  139.  
  140. o Groups pane 
  141. o View contents 
  142. o Changing the list of objects associated with a group 
  143.  
  144.  
  145. ΓòÉΓòÉΓòÉ 8. Help for Create Group ΓòÉΓòÉΓòÉ
  146.  
  147. This choice creates another group.  To change name of the group, use direct 
  148. edit (Shift+F9 or Alt+mouse button 1). 
  149.  
  150.  
  151. ΓòÉΓòÉΓòÉ 9. Help for Delete (Group) ΓòÉΓòÉΓòÉ
  152.  
  153. This choice deletes the group.  The objects that were associated with the 
  154. deleted group are added to the Other group's list of associated objects. 
  155.  
  156. Related information: 
  157.  
  158. o What is the Other group? 
  159.  
  160.  
  161. ΓòÉΓòÉΓòÉ 10. Help for Create Standard Groups ΓòÉΓòÉΓòÉ
  162.  
  163. This choice creates several standard groups and fills each of them with copies 
  164. or shadows of many of the objects shipped with OS/2. These groups organize the 
  165. objects into easily understood categories. If you have never used a Group View 
  166. before, select this choice to see an example of its use. 
  167.  
  168. Note:  All the objects created by the Create standard groups choice are either 
  169.        shadows of existing objects, or copies of existing objects; they can be 
  170.        safely deleted from the Group Folder when you no longer need them. 
  171.  
  172. If you did not install all of OS/2 options, some of the objects above may not 
  173. be created. 
  174.  
  175. The list of groups and objects created when Create standard groups is selected: 
  176.  
  177. Development     Enhanced Editor 
  178.                 Seek and Scan Files 
  179.                 OS/2 Window 
  180.                 OS/2 Full Screen 
  181.                 Command Reference 
  182.                 Icon Editor 
  183.  
  184. Games           Solitaire - Klondike 
  185.                 Reversi 
  186.                 OS/2 Chess 
  187.                 Games folder (shadow) 
  188.  
  189. System          OS/2 System folder (shadow) 
  190.                 Startup folder (shadow) 
  191.                 System (shadow) 
  192.  
  193. Palettes        Color Palette 
  194.                 Font Palette 
  195.                 Scheme Palette 
  196.  
  197. Misc            Templates folder (shadow) 
  198.                 Minimized Window Viewer (shadow) 
  199.                 Shredder (shadow) 
  200.                 Drives folder (shadow) 
  201.                 Desktop (shadow) 
  202.  
  203. Help            Master Help Index 
  204.                 Information folder (shadow) 
  205.                 Start Here 
  206.                 Glossary 
  207.  
  208.  
  209. ΓòÉΓòÉΓòÉ 11. Product Information ΓòÉΓòÉΓòÉ
  210.  
  211. Copyright (C), IBM Corporation 1993 
  212.  
  213. Group View is an alternative view of folder contents.  For more information, 
  214. see the GFOLDER FORUM on IBMPC or section 3, Object Technology, of the OS2DF1 
  215. forum on CompuServe (Dan Kehn, ID 74140,3263). 
  216.  
  217. Related information: 
  218.  
  219. o Why use Group Folder? 
  220.  
  221.  
  222. ΓòÉΓòÉΓòÉ 12. Help for View contents ΓòÉΓòÉΓòÉ
  223.  
  224. This choice displays the objects associated with the chosen group in the 
  225. Contents pane. Select this choice or double-click a group with mouse button 1. 
  226.  
  227. Note:  The objects associated with only one group can be shown in the Contents 
  228. pane at any given time. 
  229.  
  230. Related information: 
  231.  
  232. o Groups pane 
  233. o Contents pane 
  234.  
  235.  
  236. ΓòÉΓòÉΓòÉ 13. Help for Selected Contents ΓòÉΓòÉΓòÉ
  237.  
  238. This category of choices is primarily intended for keyboard users.  It allows 
  239. the objects selected in the Contents pane to be associated with another group, 
  240. copied and the copies associated with another group, or shadowed and the 
  241. shadows associated with another group. 
  242.  
  243. Content selection choices: 
  244.  
  245. o Change group 
  246. o Add to group 
  247. o Remove from group 
  248. o Copy 
  249. o Create shadow 
  250.  
  251. Related information: 
  252.  
  253. o What is the Groups pane on the left? 
  254. o What is the Contents pane on the right? 
  255.  
  256.  
  257. ΓòÉΓòÉΓòÉ 14. Help for Change Group (Selected Contents) ΓòÉΓòÉΓòÉ
  258.  
  259. The Change group choice is primarily intended for keyboard users.  It allows 
  260. you to associated the objects selected in the Contents pane with another group. 
  261.  
  262. Select this choice or drag one or more objects shown in the Contents pane to 
  263. one of the groups shown in the Groups pane. 
  264.  
  265. Related information: 
  266.  
  267. o Selected contents 
  268.  
  269.  
  270. ΓòÉΓòÉΓòÉ 15. Help for Add to Group (Selected Contents) ΓòÉΓòÉΓòÉ
  271.  
  272. The Add to group choice allows the objects selected in the Contents pane to be 
  273. added to another group.  It allows you to associate an object in the Contents 
  274. pane with one or more groups. 
  275.  
  276. Note:  An object can be associated with more than one group, but can only be 
  277. associated with the same group once. 
  278.  
  279. Related information: 
  280.  
  281. o Selected contents 
  282.  
  283.  
  284. ΓòÉΓòÉΓòÉ 16. Help for Remove from Group (Selected Contents) ΓòÉΓòÉΓòÉ
  285.  
  286. The Remove from group choice allows the objects selected in the Contents pane 
  287. to be removed from a group. 
  288.  
  289. Note:  A contained object is always associated with at least one group.  If an 
  290. object's last association is deleted, a new association is automatically added 
  291. to the Other group. 
  292.  
  293. Related information: 
  294.  
  295. o Selected contents 
  296. o What is the Other group? 
  297.  
  298.  
  299. ΓòÉΓòÉΓòÉ 17. Help for Copy (Selected Contents) ΓòÉΓòÉΓòÉ
  300.  
  301. The Copy choice is primarily intended for keyboard users.  It allows you to 
  302. copy and then associate the objects selected in the Contents pane with another 
  303. group. 
  304.  
  305. Select this choice or drag one or more objects shown in the Contents pane to 
  306. one of the groups shown in the Groups pane.  For example, an object shown in 
  307. the Contents pane on the right can be copied then associated with a different 
  308. group by dragging it (while holding the Ctrl key) to one of the groups shown in 
  309. the Groups pane on the left. 
  310.  
  311. Related information: 
  312.  
  313. o Selected contents 
  314. o View contents 
  315.  
  316.  
  317. ΓòÉΓòÉΓòÉ 18. Help for Create Shadow (Selected Contents) ΓòÉΓòÉΓòÉ
  318.  
  319. The Create shadow choice is primarily intended for keyboard users.  It allows 
  320. you to create shadows and then associate the objects selected in the Contents 
  321. pane with another group. 
  322.  
  323. The same result can be accomplished by dragging one or more objects shown in 
  324. the Contents pane to one of the groups shown in the Groups pane.  For example, 
  325. a shadow can be created for an object shown in the Contents pane on the right 
  326. then associated with a different group by dragging it (while holding the Ctrl 
  327. and Shift keys) to one of the groups shown in the Groups pane on the left. 
  328.  
  329. Related information: 
  330.  
  331. o Selected contents 
  332. o View contents 
  333.  
  334.  
  335. ΓòÉΓòÉΓòÉ 19. Help for Folder (menu bar) ΓòÉΓòÉΓòÉ
  336.  
  337. Choose the Folder menu bar choice to display a pulldown menu containing choices 
  338. affecting the folder as a whole.  More specific help can be requested from the 
  339. individual pulldown menu choices. 
  340.  
  341. Related information: 
  342.  
  343. o Create standard groups 
  344. o Create group 
  345.  
  346.  
  347. ΓòÉΓòÉΓòÉ 20. Help for View (menu bar) ΓòÉΓòÉΓòÉ
  348.  
  349. Choose the View menu bar choice to show a pulldown menu containing choices 
  350. affecting the presentation of the Group View. 
  351.  
  352. The Sort groups choice sorts the groups alphabetically. 
  353.  
  354. The Sort contents choice sorts the objects in the currently shown group 
  355. alphabetically. 
  356.  
  357. The Hide on open choice, if checked, will result in the Group View being hidden 
  358. when you open an object shown in the Group View by double-clicking it or by 
  359. choosing Enter. 
  360.  
  361.  
  362. ΓòÉΓòÉΓòÉ 21. Help for Selected (menu bar) ΓòÉΓòÉΓòÉ
  363.  
  364. Choose the Selected menu bar choice to display a pulldown menu containing 
  365. choices affecting the currently selected objects in the pane that last had the 
  366. location cursor, either the Contents pane or Groups pane. 
  367.  
  368. Related information: 
  369.  
  370. o What is the Groups pane on the left? 
  371. o What is the Contents pane on the right? 
  372.  
  373.  
  374. ΓòÉΓòÉΓòÉ 22. Help for Sort Groups ΓòÉΓòÉΓòÉ
  375.  
  376. The Sort groups choice sorts the 
  377.  
  378.  
  379. ΓòÉΓòÉΓòÉ 23. Programming API for Group Folder ΓòÉΓòÉΓòÉ
  380.  
  381. The Group Folder supports Workplace Shell setup strings.  These strings can be 
  382. passed to a Group Folder to create groups and objects within the groups. 
  383. Generally this is done as part of a customized Group Folder installation. 
  384.  
  385. NEWGROUP=           Title of group to create. 
  386.  
  387. CREATEOBJECT=       New object title. 
  388.  
  389. CLASS=              Class of new object. 
  390.  
  391. IFEXISTS=           Action to take if an object with the same title already 
  392.                     exists in the Group Folder.  Valid values are FAIL, UPDATE, 
  393.                     or REPLACE. 
  394.  
  395. INGROUP=            Title of  the group to place the new object in.  If 
  396.                     unspecified, the new object is placed in the Other group. 
  397.  
  398. The setup string below would create a program in group "Productivity Programs": 
  399.  
  400.  NEWGROUP=Productivity Programs;
  401.  CREATEOBJECT=Enhanced Editor;
  402.  CLASS=WPProgram;
  403.  IFEXISTS=REPLACE;
  404.  INGROUP=Productivity Programs;
  405.  EXENAME=?:\OS2\APPS\EPM.EXE;
  406.  PROGTYPE=PM
  407.  
  408. This setup string can be passed to the Group Folder using the WinSetObjectData 
  409. API, the REXX SysSetObjectData, or the Workplace Shell wpSetup method.  The 
  410. Group Folder creates an instance of the class specified in the CLASS keyword 
  411. and passes it the entire setup string passed to the Group Folder including the 
  412. NEWGROUP, CREATEOBJECT, CLASS, and INGROUP keywords (which should be ignored by 
  413. the newly created instance). 
  414.  
  415. Note:  Only one object can be created per setup invocation because the 
  416. NEWGROUP, CREATEOBJECT, CLASS, IFEXISTS, and INGROUP keywords can only be 
  417. specified once in the setup string. 
  418.  
  419. Other Group Folder setup strings: 
  420.  
  421. QUERYGROUPCONTENT   Returns the Group Folder contents (gfx) into a named shared 
  422.                     memory object: 
  423.  
  424.                                         typedef struct // gfg
  425.                                         {
  426.                                           PSZ pszTitle;         // group title
  427.                                           ULONG cObjects;       // number of objects in group
  428.                                           HOBJECT *phObject;    // pointer to array of object handles
  429.                                         } GFGROUP, *PGFGROUP;
  430.  
  431.                                         typedef struct // gfx
  432.                                         {
  433.                                           ULONG cb;             // size of entire export buffer
  434.                                           ULONG cgfg;           // number of groups
  435.                                           GFGROUP gfg[1];       // array of groups
  436.                                         } GFEXPORT, *PGFEXPORT;
  437.  
  438. QUERYGROUPCONTENTLENGTH Returns the length of the Group Folder contents into a 
  439.                     named shared memory object. 
  440.  
  441. RENAMEDEFAULTGROUP= Rename the default group. 
  442.  
  443. VIEWGROUP=          Display the objects in the named group. 
  444.  
  445. Group Folder setup strings whose parameter value is the object handle in 
  446. hexidecimal followed by the group name. For example: 
  447.  
  448. ADDOBJECTHANDLETOGROUP=2F03A,Games;
  449.  
  450. Note:  The object handle must belong to an object already existing in the Group 
  451. Folder. 
  452.  
  453. ADDOBJECTHANDLETOGROUP= Adds the object with the specified handle to the named 
  454.                     group. After this operation, the object may be referenced 
  455.                     by more than one group. 
  456.  
  457. MOVEOBJECTHANDLETOGROUP= Moves the object with the specified handle to the 
  458.                     named group. After this operation, the object is referenced 
  459.                     by only one group. 
  460.  
  461. REMOVEOBJECTHANDLEFROMGROUP= Removes the object with the specified handle from 
  462.                     the named group only if it is in more than one group. 
  463.