home *** CD-ROM | disk | FTP | other *** search
/ Power GUI Programming with VisualAge C++ / powergui.iso / trialva / ibmcppw / samples / visbuild / rapsheet / readme.txt < prev    next >
Encoding:
Text File  |  1996-02-20  |  8.1 KB  |  184 lines
  1. **********************************************************************
  2. * DISCLAIMER OF WARRANTIES:                                          *
  3. *                                                                    *
  4. * The following enclosed code is sample code created by IBM          *
  5. * Corporation.  This sample code is not part of any standard IBM     *
  6. * product and is provided to you solely for the purpose of assisting *
  7. * you in the development of your applications.  The code is provided *
  8. * "AS IS", without warranty of any kind.  IBM shall not be liable    *
  9. * for any damages arising out of your use of the sample code, even   *
  10. * if they have been advised of the possibility of such damages.      *
  11. *                                                                    *
  12. **********************************************************************
  13.  
  14. POLICE RAP SHEET
  15.  
  16.   DESCRIPTION:
  17.        This application retrieves information about
  18.        suspects and displays the list of the
  19.        suspects in a container.  A notebook is used to
  20.        display detailed information about a suspect.
  21.  
  22.        This application consists of a set of visual and
  23.        nonvisual parts.  The code for the nonvisual
  24.        parts is already written, compiled, and linked
  25.        into a DLL named CPPWV23.DLL.
  26.  
  27.        The visual parts were built and connected into
  28.        an application with the nonvisual parts using
  29.        the C++ Visual Builder Tool.  The set of visual
  30.        parts that comprise this application are
  31.        represented by the Visual Builder "class file"
  32.        VBRPSHTV.VBB.  This file also contains handler
  33.        classes as class interface parts.
  34.  
  35.   CONCEPT/FEATURE:
  36.        How to build a simple GUI application using the
  37.        Visual Builder.
  38.  
  39.        Refer to VBRAPSHT.SPC for the specifications of
  40.        this application.
  41.  
  42.  
  43.   HOW TO RUN THE SAMPLE:
  44.  
  45.        Note:  When you run this application, data is primed into
  46.               the following .ini files:
  47.                  isuspect.ini
  48.                  ialias.ini
  49.                  iarrest.ini
  50.               On Windows, .ini files are stored in the Windows
  51.               registry as Software. If you want to delete this
  52.               data, Microsoft provides a tool that allows you
  53.               to modify its registry.
  54.  
  55.        From within the WorkFrame environment:
  56.              1. Open the VisualAge for C++ product object.
  57.              2. Open the Guide to Samples notebook.
  58.              3. Select "Visual Builder Samples" from the
  59.                 Component drop down list.
  60.              4. Select "RapSheet" from the List of Samples.
  61.              5. Click the "Open Project" button to open the
  62.                 project view.
  63.              6. Click on the RUN button of the project's toolbar.
  64.              7. Click on the Witness Identification graphic push
  65.                 button (NOTE: the other 2 graphic buttons do not
  66.                 do anything).
  67.  
  68.        From the command line:
  69.              1. Set the current drive as the drive where you
  70.                 installed the VisualAge C++ samples.
  71.              2. Set the directory path for this sample
  72.                 as follows:
  73.                    cd ibmcppw\samples\visbuild\rapsheet
  74.              3. Set the path environment variable as follows:
  75.                    set path=.;.\cppwv23;%path%
  76.                 This enables the resource DLL, CPPWV23R.DLL,
  77.                 and the code DLL for the nonvisual parts,
  78.                 CPPWV23.DLL, to be loaded.
  79.              4. Type the name of the .EXE file, RPMNVIEW.
  80.              5. Click on the Witness Identification graphic push
  81.                 button (NOTE: the other 2 graphic buttons do not
  82.                 do anything).
  83.  
  84.  
  85.   HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  86.  
  87.        To regenerate this application's source, do the
  88.        following from the main Visual Builder window:
  89.  
  90.           1. Load all the "class files" used by this sample
  91.              application by following the steps outlined in the
  92.              "HOW TO INSPECT THE SAMPLE PARTS USING THE VISUAL
  93.              BUILDER" section.
  94.           2. Select all the parts in the "Visual Parts" list
  95.              and then select "Part->Generate->Part source"
  96.              from the menu bar.
  97.           3. Select only the "IRapMainView" part in the
  98.              "Visual Parts" list and then select
  99.              "Part->Generate->main() for part" from the
  100.              menu bar.
  101.  
  102.              NOTE: if you plan on building the
  103.              application from the command line, be sure
  104.              the "Generate make files" selection is checked
  105.              for the Options choice on the main Visual
  106.              Builder window before you generate main()
  107.              for the IRapMainView part.
  108.  
  109.        To build the application from within this WorkFrame
  110.        sample project:
  111.              1. Invoke a Project Build Action.
  112.  
  113.        To build the application from the command line:
  114.              1. Set the current drive as the drive where you
  115.                 installed the VisualAge C++ samples.
  116.              2. Set the directory path for this sample
  117.                 as follows:
  118.                    cd ibmcppw\samples\visbuild\rapsheet
  119.              3. Set the include environment variable as follows:
  120.                    set include=.;.\cppwv23;%include%
  121.                 This enables the header files for the nonvisual
  122.                 parts to be included.
  123.              4. Set the lib environment variable as follows:
  124.                    set lib=.;.\cppwv23;%lib%
  125.                 This enables the import library for the nonvisual
  126.                 parts, CPPWV23.LIB, to be linked.
  127.              5. Build the EXE by typing the following from the
  128.                 command line:
  129.                    nmake -f rpmnview.mak
  130.  
  131.        To run the sample application, see the section, "HOW TO RUN
  132.        THE SAMPLE".
  133.  
  134.  
  135.   HOW TO INSPECT THE SAMPLE PARTS USING THE VISUAL BUILDER
  136.  
  137.        There are two "class files" that make up this sample
  138.        application, VBRPSHTV.VBB and VBRPSHTN.VBB.  VBRPSHTV.VBB
  139.        contains all the visual parts built using the Visual Builder.
  140.        It also contains class interface parts that represent handler
  141.        classes.  These parts are used by some of the visual parts.
  142.        VBRPSHTN.VBB contains all the nonvisual parts.  For a
  143.        description of the parts these "class files" contain,
  144.        see the specifications file, VBRAPSHT.SPC.
  145.  
  146.        The VBRPSHTV.VBB file also requires the Visual Builder
  147.        "class file", VBSAMPLE.VBB, to be loaded.
  148.  
  149.        From within the WorkFrame environment:
  150.              1. Open the sample project view as described
  151.                 above. In the project window you will see
  152.                 the icons of the files associated with the sample.
  153.              2. From the project view of this sample, select
  154.                 "Visual" from the Project pulldown.
  155.  
  156.        From the command line:
  157.              1. Set the current drive as the drive where you
  158.                 installed the VisualAge C++ samples.
  159.              2. Set the directory path for this sample
  160.                 as follows:
  161.                    cd ibmcppw\samples\visbuild\rapsheet
  162.                 This will allow Visual Builder to automatically
  163.                 load all the Visual Builder "class files"
  164.                 this samples uses.  These files are listed
  165.                 in the file VBLOAD.DAT in this directory.
  166.  
  167.                 This also allows Visual Builder to find the
  168.                 resource DLL, CPPWV23R.DLL, this sample uses.
  169.                 This resource DLL contains the various bitmaps
  170.                 and icons used by this application.
  171.              3. Start the Visual Builder Tool by typing the
  172.                 following from the command line:
  173.                    ivb
  174.  
  175.  
  176.   ADDITIONAL INFORMATION:
  177.        For additional information on this and other samples shipped
  178.        with the VisualAge for C++ product, please see the Guide to Samples
  179.        notebook.
  180.  
  181.        To access the notebook from Program Manager, open the
  182.        VisualAge for C++ product object, then open the Guide to Samples
  183.        notebook.
  184.