home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 1 / RISC_DISC_1.iso / pd_share / code / desklib / Examples / !TestApp / !Help next >
Encoding:
Text File  |  1994-05-29  |  2.5 KB  |  60 lines
  1. Help for !TestApp
  2. =================
  3.  
  4. This small application is used both as a small test for DeskLib
  5. and as a demonstration of some of the main facilities provided
  6. by the library.
  7.  
  8. NOTE that it now tests the outline font handling code, and needs
  9. the fonts Homerton and Trinity to be available in order to run.
  10.  
  11.  
  12. Double click its icon to run it.
  13.  
  14. First, it will run the hourglass for 1 second as a test.
  15.  
  16. Three windows should appear (one will appear as it was defined in
  17. the template file, one will be centered on screen, and the last
  18. will appear under the mouse pointer.
  19.  
  20. These windows now use RISC OS 3.10 bordered icons, so you will only
  21. get a '3d' look to them if you have RISC OS 3.10 or later. They should
  22. also include several different styles of 2 outline fonts.
  23. (To test the font handlers, try changing between lo-res and hi-res
  24. screenmodes (e.g 9, 12, 20) - if the font stays the correct size,
  25. everything is working as it should)
  26.  
  27. Clicking MENU over the iconbar icon or any window will pop up a demo
  28. menu with the following items:
  29.   Change Title - an item which beeps when clicked, with a dotted line
  30.                  underneath. This will be shaded if you brought the menu up
  31.                  over the iconbar. If you select it (when brought up over a
  32.                  window) then the window's title text will be changed.
  33.   Item 1       - a shaded item
  34.   Item 2       - an item which produces an error box when clicked...
  35.                  It also leads to a submenu:
  36.     Indirected text   - an item with more than 12 characters in it
  37.                         Click here with select or Adjust to tick it
  38.     Short text        - another item which can be ticked instead.
  39.     Extension 1      }- Two menu items which have been added to the menu
  40.     Extension 2      }  to test "Menu_Extend()"
  41.   Quit         - Click here to quit the application
  42.  
  43. ---
  44.  
  45. The source code to create !TestApp with is contained inside the application.
  46. The code is heavily commented to tell you everything it is doing, and is
  47. pretty short & simple. It is a good place to look when starting to figure
  48. out just how to use DeskLib.
  49.  
  50. Note that TestApp includes almost all of the DeskLib library, but has very
  51. little functionality - it is thus extremely large for what it does! However,
  52. when you start to add more functionality, the size usually comes out far more
  53. reasonable! Of course, you do not need to include all of DeskLib's code in
  54. your own applications - if you just stick to the SWI veneers, you will get
  55. a very compact, fast application out of it.
  56.  
  57. ---
  58.  
  59. Jason Williams May 1993
  60.