home *** CD-ROM | disk | FTP | other *** search
/ Computer Club Elmshorn Atari PD / CCE_PD.iso / pc / 0600 / CCE_0643.ZIP / CCE_0643 / GBNCH340 / HGT.TXT < prev    next >
Text File  |  1994-01-02  |  5KB  |  128 lines
  1. HiSoft GEM Toolbox
  2. ==================
  3.  
  4. The HGT is a set of modules that a programmer can include in his
  5. programs to enhance the standard GEM interface. The modules
  6. borrow ideas (in concept, but not in actual code) from MyDials
  7. and Let'em Fly as well as E_GEM.
  8.  
  9. So what does it all mean to the user of an HGT based program?
  10.  
  11.  
  12. The HGT Interface
  13. -----------------
  14.  
  15. The interface is based on the standard GEM interface so that it
  16. is fully compatible with it. You may use it just as you would any
  17. standard GEM program. It does offer many enhancements, but these
  18. do not conflict with standard operation.
  19.  
  20.  
  21. Window Dialogs
  22. --------------
  23.  
  24. HGT dialog boxes are drawn inside GEM windows. This means that
  25. you may open several dialogs at the same time and you always have
  26. access to the menu bar and to desk accessories. If you run under
  27. a multi-tasking system you also have access to other programs
  28. while a dialog box is open.
  29.  
  30. Window dialogs need not be 'topped'. You may use the right mouse
  31. button to click on a background window. Closing a window dialog
  32. with the Closer gadget on the top left corner is the same as
  33. pressing the Cancel button in that dialog.
  34.  
  35.  
  36. Flying Dialogs
  37. --------------
  38.  
  39. Some dialogs are not placed in a window. Instead they have a
  40. 'dog-ear' on the top right corner which may be used to move the
  41. dialog around the screen. Pressing the mouse outside the dialog
  42. makes it 'fly'. You will also notice that flying dialogs are much
  43. quicker to clear on exit.
  44.  
  45.  
  46. Keyboard Shortcuts
  47. ------------------
  48.  
  49. Buttons in a dialog may have a keyboard equivalent which is
  50. indicated with an underscore. To activate it, press the
  51. underlined key while holding Alternate. In addition, any button
  52. that is marked Cancel, Abort, No, Exit or Undo may be selected by
  53. pressing the Undo key on your keyboard.
  54.  
  55.  
  56. Popup Menus
  57. -----------
  58.  
  59. If a program uses popup menus, they are normally indicated by a
  60. shadowed button with a little cycle icon to its right. The
  61. simplest way of using a popup menu is to click on the shadowed
  62. button. This pops a menu which is used much like the standard
  63. menu bar. Additionally, you may use the cursor keys to move up
  64. and down the menu items. Pressing ClrHome selects the first item
  65. and pressing Shift+ClrHome selects the bottom item. To exit the
  66. menu click the mouse over a selection or press Return. To cancel
  67. the menu press Undo or click the mouse outside the menu.
  68.  
  69. Menu entries may have keyboard equivalents which are indicated
  70. inside the popup menu, on the right of each menu item. You may
  71. use these without having to display the menu.
  72.  
  73. The cycle icon allows you to scroll through the menu entries
  74. without having to display it first.
  75.  
  76.  
  77. Window Menus
  78. ------------
  79.  
  80. The HGT incorporates window menu bars. A window may have a menu
  81. bar similar to the one at the top of the screen. This is started
  82. by clicking once on the bar. The menu is used much like popup
  83. menus and uses all the keyboard shortcuts that are available in a
  84. popup menu. Additionally, you can use the left and right cursor
  85. keys to move sideways along the menus. Pressing Alternate+Esc
  86. also starts the menu.
  87.  
  88.  
  89. Toolbars
  90. ----------
  91.  
  92. HGT windows may have a toolbar at the top of the window. The
  93. tools work much like standard buttons in dialog boxes, so
  94. hopefuly no further explanation is needed.
  95.  
  96.  
  97. Editable Fields
  98. ---------------
  99.  
  100. If the program has any editable text fields, these are much nicer
  101. to use than the standard GEM ones. The extended features are
  102. listed below:
  103.  
  104. ClrHome -                jump to first editable field
  105. Shift+ClrHome -          jump to last editable field
  106. Tab or down arrow -      move one field forward with wrap
  107. Shift+Tab or up arrow -  move one field back with wrap
  108. Shift+left arrow -       move to start of field
  109. Shift+right arrow -      move to end of field
  110. Control+left -           move back one word
  111. Control+right -          move forward one word
  112. Control+Delete -         delete text from cursor position
  113. Control+Backspace -      delete text up to cursor
  114. Shift+Insert -           Display ASCII table.
  115.  
  116. The Shift+Insert ASCII table lets you enter extended characters
  117. which are not available from the keyboard.
  118.  
  119. In adition, you can move the cursor to any valid position with
  120. the mouse. Simply click the mouse on the the editable field and
  121. the cursor will jump to that point.
  122.  
  123. IMPORTANT: Because of the way the HGT allocates system memory
  124. dynamically, we strongly recommend that you install the program
  125. FOLDER100.PRG in your auto folder. This applies to ALL TOS
  126. versions.
  127.  
  128.