home *** CD-ROM | disk | FTP | other *** search
/ Power GUI Programming with VisualAge C++ / powergui.iso / trialva / ibmcppw / samples / visbuild / calculat / readme.txt < prev   
Encoding:
Text File  |  1996-02-19  |  8.3 KB  |  187 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. CALCULATOR
  15.  
  16.   DESCRIPTION:
  17.        The calculator application is one of many
  18.        applications that are being used to test the C++
  19.        Visual Builder.  It is included in this driver of the
  20.        product as a sample for viewing, execution, and
  21.        building purposes.
  22.  
  23.        The calculator consists of a set of visual and
  24.        non-visual parts.  The code for the non-visual
  25.        parts is already written, compiled, and linked
  26.        into a DLL named CPPWV13.DLL.
  27.  
  28.        The visual parts were built and connected into
  29.        an application with the non-visual parts using
  30.        the C++ Visual Builder Tool.  The two visual
  31.        parts that comprise the calculator are
  32.        represented by the Visual Builder "class files"
  33.        CLCLTRVW.VBB and KYPDVIEW.VBB.
  34.  
  35.   CONCEPT/FEATURE:
  36.        Refer to AVLTCAL2.SPC for specifications of this
  37.        application.
  38.  
  39.   HOW TO RUN THE SAMPLE:
  40.  
  41.        From within the WorkFrame environment:
  42.                  1. Open the VisualAge for C++ product object.
  43.                  2. Open the Guide to Samples notebook.
  44.                  3. Select "Visual Builder Samples" from the
  45.                     Component drop down list.
  46.                  4. Select "Calculator" from the List of Samples.
  47.                  5. Click the "Open Project" button to open the
  48.                     project view.
  49.                  6. Click on the RUN button of the project's toolbar.
  50.  
  51.        From the command line:
  52.                  1. Set the current drive as the drive where you
  53.                     installed the VisualAge C++ samples.
  54.                  2. Set the directory path for the this sample
  55.                     as follows:
  56.                        cd ibmcppw\samples\visbuild\calculat
  57.                  3. Set the path environment variable as follows:
  58.                        set path=.\cppwv13;%path%
  59.                  4. Type the name of the .EXE file, CLCLTRVW.
  60.  
  61.  
  62.   HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  63.  
  64.        From within the WorkFrame environment:
  65.                  Open the sample project view as described
  66.                  above. In the project window you will see
  67.                  the icons of the files associated with the sample.
  68.  
  69.                  Start the Visual Builder component of
  70.                  VisualAge C++ by selecting Visual from
  71.                  the Project pulldown.  From the main
  72.                  Visual Builder Window:
  73.  
  74.                    1. Select from the Menubar the "File->Load"
  75.                       option.
  76.                    2. The Load Files dialog will appear with a list
  77.                       of "class files" that may be loaded.  Select
  78.                       from the list the files CLCLTRVW.VBB,
  79.                       KYPDVIEW.VBB, and ICALCPRT.VBB and
  80.                       press the "OK" button. (The ICALCPRT.VBB
  81.                       file contains the already imported Parts
  82.                       Interface Defintions for the calculator
  83.                       non-visual parts.)
  84.                    3. Select all the parts in the "Visual
  85.                       Parts" list and then select
  86.                       "Part->Generate->Part source"
  87.                       from the Menubar.
  88.                    4. Select only the "CalculatorView"
  89.                       part in the "Visual Parts" list and
  90.                       then select
  91.                       "Part->Generate->main() for part"
  92.                       from the Menubar.
  93.                    5. Now invoke a Project Build Action.
  94.  
  95.                  To run the sample project, see How to
  96.                  run the sample project above.
  97.  
  98.        From the command line:
  99.                  Start the Visual Builder component of
  100.                  VisualAge C++ by typing:
  101.  
  102.                    ivb
  103.  
  104.                  From the main Visual Builder Window:
  105.  
  106.                    1. Select from the Menubar the "File->Load"
  107.                       option.  On the Load Files dialog page,
  108.                       set the dialog to the drive and subdirectory
  109.                       that contain the CLCLTRVW application.
  110.                    2. The Load Files dialog will appear with a list
  111.                       of "class files" that may be loaded.  Select
  112.                       from the list the files CLCLTRVW.VBB,
  113.                       KYPDVIEW.VBB, and ICALCPRT.VBB and
  114.                       press the "OK" button. (The ICALCPRT.VBB
  115.                       file contains the already imported Parts
  116.                       Interface Defintions for the calculator
  117.                       non-visual parts.)
  118.                    3. Select all the parts in the "Visual
  119.                       Parts" list and then select
  120.                       "Part->Generate->Part source"
  121.                       from the Menubar.
  122.                    4. Select only the "CalculatorView"
  123.                       part in the "Visual Parts" list and
  124.                       then select
  125.                       "Part->Generate->main() for part"
  126.                       from the Menubar.
  127.                    5. From the command line, make this
  128.                       sample's directory the current directory
  129.                       as described above.
  130.                    6. Set the environment variables as follows:
  131.                          set include=.\cppwv13;%include%
  132.                          set lib=.\cppwv13;%lib%
  133.                    7. Build the EXE by executing the MAKE as follows:
  134.                          nmake clcltrvw.mak
  135.                    8. You may optionally build the DLL, CPPWV13.DLL, which
  136.                       contains the code support for the non-visual parts
  137.                       used in this sample as follows:
  138.                          cd cppwv13
  139.                          nmake makefile.mak
  140.  
  141.  
  142.   HOW TO INSPECT THE VISUAL PARTS USING THE VISUAL BUILDER
  143.  
  144.        There are three "class files" that make up the
  145.        application, CLCLTRVW.VBB, KYPDVIEW.VBB, and
  146.        ICALCPRT.VBB.
  147.  
  148.          1. Start the Visual Builder Tool -- from the
  149.             command line, type:
  150.  
  151.                ivb
  152.  
  153.             or from the project view of the
  154.             sample select "Visual" from the Project
  155.             pulldown.
  156.          2. When the Visual Builder Window appears,
  157.             select from the Menubar the "File->Load"
  158.             option.
  159.          3. The Load Files dialog will appear with a list
  160.             of "class files" that may be loaded.  Select
  161.             from the list the files CLCLTRVW.VBB,
  162.             KYPDVIEW.VBB, and ICALCPRT.VBB and
  163.             press the "OK" button. (The ICALCPRT.VBB
  164.             file contains the already imported Parts
  165.             Interface Defintions for the calculator
  166.             non-visual parts.)
  167.          4. You may now select CLCLTRVW.VBB and
  168.             KYPDVIEW.VBB from the "Loaded Part Files"
  169.             list in the Visual Builder Window.  This will
  170.             display "calculatorView" and "keypadView"
  171.             in the "Visual Parts" list of this Window.
  172.          5. You may now select either or both of these
  173.             parts from the "Visual Parts" list and then
  174.             select "Part->Open" from the Menubar to
  175.             open these parts for viewing and/or
  176.             editting.
  177.  
  178.  
  179.   ADDITIONAL INFORMATION:
  180.        For additional information on this and other samples shipped
  181.        with the VisualAge for C++ product, please see the Guide to Samples
  182.        notebook.
  183.  
  184.        To access the notebook from Program Manager, open the
  185.        VisualAge for C++ product object, then open the Guide to Samples
  186.        notebook.
  187.