home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / ucmen212.zip / READ.ME next >
Text File  |  1996-05-31  |  5KB  |  100 lines
  1. /************************************************************************/
  2. /************************************************************************/
  3. /*                      DISCLAIMER OF WARRANTIES.                       */
  4. /************************************************************************/
  5. /************************************************************************/
  6. /*     The following [enclosed] code is source code created by the      */
  7. /*     author(s).  This source code is provided to you solely           */
  8. /*     for the purpose of assisting you in the development of your      */
  9. /*     applications.  The code is provided "AS IS", without             */
  10. /*     warranty of any kind.  The author(s) shall not be liable         */
  11. /*     for any damages arising out of your use of the source code,      */
  12. /*     even if they have been advised of the possibility of such        */
  13. /*     damages.  It is provided purely for instructional and            */
  14. /*     illustrative purposes.                                           */
  15. /************************************************************************/
  16. /************************************************************************/
  17.  
  18. Description:
  19. ------------
  20. The User Customizable Menu (UCMenu) is a very powerful "toolbar" custom
  21. PM control.  It allows the user to define the ordering of menu items and
  22. visual representation (artwork and text) of menu items.   Most
  23. customization functions are encapsulated inside the control itself,
  24. greatly reducing the application code needed to support a customizable
  25. toolbar.  Extensive use is made of direct manipulation for a smooth
  26. integration with the OS/2 Workplace Shell.  For example, to reorder
  27. items on the toolbar, the user can just drag/drop items into new
  28. positions.  Dragging a toolbar item to the shredder will delete it.  A
  29. context menu gives quick access to other customization functions.
  30.  
  31. This package contains the complete UCMenu custom PM control including
  32. all source code.  It also includes several working sample programs that
  33. demonstrate the appearence and operation of the toolbar.  Also
  34. included is a programmers toolkit reference in OS/2 VIEW format.
  35.  
  36. This control was described in an artical in OS/2 Developer magazine,
  37. Jan/Feb 1995, page 50.
  38.  
  39. Version Notice:
  40. ---------------
  41. This is Version 2.12 of UCMenus and completely replaces earlier versions
  42. which have been made available through various means.  Version 2.12
  43. is source-level compatible with with 2.0 but not binary compatible.
  44.  
  45. NOTE: Unlike prior versions of the toolkit, compiled .OBJ and .DLL files
  46. are no longer included.  You should build your own copy of the executable
  47. files using your own compiler.  See the online reference for instructions
  48. on building the OBJ and DLL files.
  49.  
  50. Installing the UCMenus Toolkit:
  51. -------------------------------
  52. To install this toolkit, run the UCMINST.CMD program from an OS/2
  53. command line.  Supply the name of a directory for installation when
  54. prompted.  All the toolkit files and samples will be placed into
  55. the specified directory.
  56.  
  57. The toolkit directory structure created will be as follows (assuming
  58. the main toolkit directory is \UCMENUS):
  59.  
  60.    \UCMENUS          -- Main directory, misc files like READ.ME
  61.       \INCLUDE       -- Header files (.H) to be #included in application
  62.       \LIB           -- Linkable object and resource files
  63.       \HELP          -- Online UCMENU documentation in VIEW (.INF) format
  64.       \SOURCE        -- Source for UCMenus and UCMenu utilties routines
  65.       \SAMPLES       -- Common files (bitmaps, etc) for all samples
  66.          \SAMP1      -- Sample #1, demo of different types of menus
  67.          \SAMP2      -- Sample #2, full menu implementation
  68.          \SAMP3      -- Sample #3, 'buffet' menu customization method
  69.  
  70.  
  71. Notes on the Samples:
  72. ---------------------
  73.  
  74. The samples contain everything needed to build the executables including
  75. make files, resource files, etc.  To keep the package size down, the
  76. intermediate code files (.OBJ and .RES) have been deleted, but the .EXE
  77. files are there so you can run the samples without compiling them.  To
  78. compile a sample, just run the OS/2 command "nmake /a all", assuming you
  79. have installed the IBM VisualAge compiler and OS/2 toolkit.
  80.  
  81. Note that the samples all use static linking of the UCMENUS custom control
  82. code.  To reduce the size of your application .EXE file, you can use dynamic
  83. linking and use the UCMENUS.DLL built in the LIB subdirectory.  When you
  84. use dynamic linking, you must name the UCMENUS.LIB file in the link
  85. command to import the DLL entry points.  Comments in the sample make files
  86. show how to do dynamic linking.
  87.  
  88. Documentation:
  89. --------------
  90.  
  91. The HELP directory contains a complete programmers toolkit reference for
  92. the UCMenu control in OS/2 VIEW (.INF) file format.
  93.  
  94. Questions?:
  95. -----------
  96. This code has no comitted level of support.  However, informal support on
  97. a time-available basis will be made available on Compuserve, OS2DF1
  98. forum, PM programming section.  TALKLINK members can also receive informal
  99. support on the OS2PMPGM CFORUM.
  100.