home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / wpobj.zip / READ.ME < prev    next >
Text File  |  1993-11-11  |  4KB  |  88 lines
  1. /************************************************************************/
  2. /*     The following [enclosed] code is library code created by the     */
  3. /*     authors.  This source code is  provided to you solely            */
  4. /*     for the purpose of assisting you in the development of your      */
  5. /*     applications.  The code is provided "AS IS", without             */
  6. /*     warranty of any kind.  The authors shall not be liable           */
  7. /*     for any damages arising out of your use of the library code,     */
  8. /*     even if they have been advised of the possibility of such        */
  9. /*     damages.                                                         */
  10. /************************************************************************/
  11.  
  12.  
  13. PALETTE INSTALLATION INSTRUCTIONS: PLEASE FOLLOW CAREFULLY
  14. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15.  
  16. 1) Copy the CLRPALET dll into a place that is on your LIBPATH. Note that
  17.    this should NOT be the '.\' directory, but rather a real named directory
  18.    that appears in your LIBPATH such as C:\OS2\DLL. Bear in mind that the '.\'
  19.    directory for the Workplace Shell process is the root of the boot drive...
  20.  
  21. 2) Run INSTALL.CMD to install the color palette folder and create instances
  22.    of ColorPalette and StarColorPalette. NOTE: it seems as though you have to
  23.    run INSTALL.CMD from the directory where CLRPALET.DLL is currently located
  24.    otherwise the second object class (StarColorPalette) won't register - I
  25.    am assuming this may be some kind of REXX problem, or a bug in Workplace
  26.    Shell.
  27.  
  28. => A folder called 'Palette Folder' should appear on your desktop containing
  29.    two palette objects that will all be opened for you by the install program.
  30.  
  31. 3) Run TESTAPP.EXE. It will popup a dialog that contains two color sample
  32.    controls that are interfaced directly with one of the color palettes
  33.    created in step(2).
  34.  
  35. => When you double click on the color sample control,
  36.    one of the palettes created in step(2) will appear and you can change
  37.    the color of the sample to any value currently in that palette of colors.
  38.  
  39. 4) Note that you can even use the WinReplaceObjectClass api to make your
  40.    color palette object classes replace the system provided color palette
  41.    class.
  42.  
  43. 5) Run UNINSTAL.CMD to uninstall the color palette folder and delete instances
  44.    of ColorPalette and StarColorPalette.
  45.  
  46. => The folder called 'Palette Folder' will be deleted from your desktop.
  47.  
  48. BUILDING THE SOURCE:
  49. ~~~~~~~~~~~~~~~~~~~~
  50.  
  51. 1) If you plan to modify and build the DLL and executable, please use the
  52.    OS/2 2.1 Toolkit, as you will get errors with the 2.0 Toolkit.  The
  53.    makefile we include, clrpalet.mak, should work with either CSet/2 or
  54.    C Set++ V2.X.
  55.  
  56.  
  57. MAKING THE WORKPLACE SHELL EASY TO START AND STOP
  58. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  59.  
  60. 1) Copy the MYSHELL.EXE program to your boot drive, for example to the C:\OS2
  61.    directory.
  62.  
  63. 2) Make a backup of your CONFIG.SYS file (just in case you mess up!).
  64.  
  65. 3) Change your CONFIG.SYS file so that MYSHELL.EXE will be run instead of
  66.    PMSHELL.EXE:
  67.  
  68.      PROTSHELL=C:\OS2\MYSHELL.EXE
  69.  
  70. 4) Reboot your machine.
  71.  
  72. => A "Workplace Shell" icon will appear in the bottom left hand corner of your
  73.    screen. You will notice that its context menu provides options that let
  74.    you start or stop the shell at any time: the program is merely using
  75.    the system provided WinStartApp() and WinTerminateApp() api calls to
  76.    start and stop the Workplace Shell executable - PMSHELL.EXE.
  77.  
  78.    MYSHELL.EXE is handy when you start developing object classes of your own
  79.    and need to update your object class dlls ...
  80.  
  81.  
  82. SYS_DLLs:
  83. ~~~~~~~~~
  84.  
  85. 1) The SYS_DLL sample program is located in PROFILE.ZIP.  Please follow
  86.    the instructions in the SYSDLL.TXT file which is included.
  87.  
  88.