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