home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / programming / desklib / examples / DeskLib / Examples / !TestApp / !Help next >
Encoding:
Text File  |  1995-08-27  |  3.5 KB  |  90 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.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. There is now a version of TestApp that is compiled for use with the DLL
  71. version of DeskLib. Because making a DLL-version involves a different
  72. set of libraries from normal, there is a second makefile for this,
  73. called '!TestApp.DLLMake'. All the .o files for the DLL version are in
  74. '!TestApp.!DLL'. Double-click on this to make the DLL version.
  75.  
  76. Double-click on !TestApp.!RunDLL to run this version (you will need to
  77. have the Straylight Dynamic Linking System installed for this to work).
  78.  
  79.  
  80.  
  81. A third version of !TestApp is now present - this has debugging enabled,
  82. and the relevant files are in '!TestApp.!Debug'. This uses the standard
  83. makefile, but calls it setting 'CCExtra' to be '-DDeskLib_DEBUG'. This
  84. is put in the call to cc, so all DeskLib Debug_ calls are implemented.
  85. Double-click on '!TestApp.!Debug' to build this version, and
  86. double-click on '!TestApp.!RunDebug' to run it.
  87.  
  88.  
  89. Julian Smith
  90.