home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv7.zip / VACPP / IBMCPP / smarts / WPS / READ.ME < prev   
Text File  |  1995-06-02  |  4KB  |  87 lines
  1.  
  2. Project Smarts - Workplace Shell application README
  3. ---------------------------------------------------
  4.  
  5. The project is organized into the following hierarchy
  6. which reflects the interdependencies between the projects:
  7.  
  8.  
  9.   ┌─────────────────────────────────────────────────────┐
  10.   │        Workplace Shell Application project          │
  11.   │ (Builds the resources for the created object class) │
  12.   └─────────────────────────────────────────────────────┘
  13.               |                            |
  14.               |                            |
  15.               v                            |
  16.  ┌───────────────────────────────────┐     |
  17.  │        Class DLL Project          │     |
  18.  │(Builds the class DLL from SOM IDL)│     |
  19.  └───────────────────────────────────┘     |
  20.                                            v
  21.                       ┌────────────────────────────────────────────┐
  22.                       │                Help Project                │
  23.                       │(Builds the help library used by the object)│
  24.                       └────────────────────────────────────────────┘
  25.  
  26.  
  27. Note:  The application's resource DLL is at the top level of the
  28.        project hierarchy because it depends on a .IH file that
  29.        is generated by the SOM Compiler in the nested Class DLL 
  30.        Project.
  31.  
  32.  
  33. Select "Build" off the project's pop-up menu to build the
  34. project executables.  Three targets are built:
  35.  
  36. 1. The WPS application's resource DLL (from the WPS Project)
  37. 2. The WPS application's class DLL (from the Class DLL Project)
  38. 3. The WPS application's help library (from the Help Project)
  39.  
  40.  
  41.  
  42. To use the WPS application once it is built:
  43. --------------------------------------------
  44.  
  45. 1. Ensure that the .HLP file produced by the nested Help Project
  46.    is visible on the HELP path.
  47.  
  48. 2. Ensure that the MYOBJRES.DLL resource library produced by the
  49.    top-level WPS project is visible on the LIBPATH path.
  50.  
  51. 3. Select the "Create" action from the project pop-up menu of the
  52.    Class DLL Project.  It invokes the CREATE.CMD script included 
  53.    with the Class DLL Project.  CREATE.CMD copies the class DLL 
  54.    to the \OS2\DLL subdirectory on your boot drive (to make it 
  55.    visible on your LIBPATH), registers your Workplace Shell class, 
  56.    and creates an instance of the class on your Desktop.
  57.  
  58. 4. To use the object created on your Desktop, drag any Workplace 
  59.    Shell object onto it.  A message box appears identifying the 
  60.    object you dropped.  Select the "Select me" menu item off the 
  61.    object's pop-up to read about the WorkPlace Shell application.
  62.  
  63.  
  64. Note on the application:
  65. ------------------------
  66.    The class is derived from the wpFilesystem WPS class, and is
  67.    therefore not a container.  Double-clicking on the object displays
  68.    the object's Settings notebook.  You can change the source code
  69.    to derive from the wpFolder WPS class instead, and add
  70.    additional processing for a container object.
  71.  
  72.  
  73. Note on the SOM Compile action
  74. ------------------------------
  75.    A hand-coded make file is provided with the Workplace Shell
  76.    Smarts application.  This is because no special actions
  77.    support is available for the SOM Compiler, so an incomplete 
  78.    list of dependencies is provided to the MakeMake utility for 
  79.    the SOM Compile action.
  80.  
  81.    You can either edit the provided make file to suit your own 
  82.    needs, or you can use MakeMake to create a make file for only 
  83.    the Compile and Link steps, and perform the SOM Compile action 
  84.    manually (select "Compile" from the pop-up menu of the IDL file).
  85.  
  86.  
  87.