home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / ucmenu.zip / READ.ME next >
Text File  |  1995-09-28  |  5KB  |  94 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.11 of UCMenus and completely replaces earlier versions
  42. which have been made available through various means.  Version 2.11
  43. is source-level compatible with with 2.0 but not binary compatible.
  44.  
  45. Installing the UCMenus Toolkit:
  46. -------------------------------
  47. To install this toolkit, run the UCMINST.CMD program from an OS/2
  48. command line.  Supply the name of a directory for installation when
  49. prompted.  All the toolkit files and samples will be placed into
  50. the specified directory.
  51.  
  52. The toolkit directory structure created will be as follows (assuming
  53. the main toolkit directory is \UCMENUS):
  54.  
  55.    \UCMENUS          -- Main directory, misc files like READ.ME
  56.       \INCLUDE       -- Header files (.H) to be #included in application
  57.       \LIB           -- Linkable object and resource files
  58.       \HELP          -- Online UCMENU documentation in VIEW (.INF) format
  59.       \SOURCE        -- Source for UCMenus and UCMenu utilties routines
  60.       \SAMPLES       -- Common files (bitmaps, etc) for all samples
  61.          \SAMP1      -- Sample #1, demo of different types of menus
  62.          \SAMP2      -- Sample #2, full menu implementation
  63.          \SAMP3      -- Sample #3, 'buffet' menu customization method
  64.  
  65.  
  66. Notes on the Samples:
  67. ---------------------
  68.  
  69. The samples contain everything needed to build the executables including
  70. make files, resource files, etc.  To keep the package size down, the
  71. intermediate code files (.OBJ and .RES) have been deleted, but the .EXE
  72. files are there so you can run the samples without compiling them.  To
  73. compile a sample, just run the OS/2 command "nmake /a all", assuming you
  74. have installed the IBM C/Set compiler and OS/2 toolkit.
  75.  
  76. Note that the samples all use static linking of the UCMENUS custom control
  77. code.  To reduce the size of your application .EXE file, you can use dynamic
  78. linking and use the UCMENUS.DLL supplied in the LIB subdirectory.  When you
  79. use dynamic linking, you must name the UCMENUS.LIB file in the LINK386
  80. command to import the DLL entry points.  Comments in the sample make files
  81. show how to do dynamic linking.
  82.  
  83. Documentation:
  84. --------------
  85.  
  86. The HELP directory contains a complete programmers toolkit reference for
  87. the UCMenu control in OS/2 VIEW (.INF) file format.
  88.  
  89. Questions?:
  90. -----------
  91. This code has no comitted level of support.  However, informal support on
  92. a time-available basis will be made available on Compuserve, OS2DF1
  93. forum, PM programming section.
  94.