home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / HELLO6 / README < prev   
Text File  |  1995-06-09  |  7KB  |  198 lines
  1. ***************************************************************************
  2. * HELLO WORLD SAMPLE PROGRAM - Version 6: Readme File readme              *
  3. *                                                                         *
  4. * COPYRIGHT: Copyright(C) International Business Machines Corp.,1992,1995.*
  5. *                                                                         *
  6. * DISCLAIMER OF WARRANTIES:                                               *
  7. *   The following [enclosed] code is sample code created by IBM           *
  8. *   Corporation.  This sample code is not part of any standard IBM product*
  9. *   and is provided to you solely for the purpose of assisting you in the *
  10. *   development of your applications.  The code is provided "AS IS",      *
  11. *   without warranty of any kind.  IBM shall not be liable for any damages*
  12. *   arising out of your use of the sample code, even if they have been    *
  13. *   advised of the possibility of such damages.                           *
  14. ***************************************************************************
  15.  
  16. Hello World
  17.  
  18.    These samples, which begin with hello1 and increase in complexity and
  19.    function up to hello6, progressively demonstrate many of the
  20.    capabilities of the User Interface Class Library.
  21.  
  22.    o   "Hello World 1"
  23.    o   "Hello World 2"
  24.    o   "Hello3"
  25.    o   "Hello4"
  26.    o   "Hello5"
  27.    o   "Hello World 6"
  28.  
  29.  
  30. Hello World 6
  31.  
  32.    DESCRIPTION:
  33.  
  34.         While this final version of the Hello World samples is much more
  35.         complex than hello1, it contains a large amount of common
  36.         application functionality and demonstrates many of the
  37.         interactions and class usage required by a real user interface
  38.         application.
  39.  
  40.         Hello6 adds all of the following:  a subclass of IHandler for
  41.         providing a new timer event; real time date and time fields on
  42.         the main window; use of a font dialog; a new settings frame
  43.         containing an INotebook object with two pages of canvases and
  44.         controls; use of IProfile class for storing the settings; and
  45.         pop-up menus for making the stars twinkle.  Hello6 also replaces
  46.         the entry field in the dialog window with a drop-down list
  47.         combination box.
  48.  
  49.    PROJECT LOCATION:
  50.         Inside the IOC Samples folder (inside the VisualAge C++ Samples
  51.         folder).
  52.  
  53.    SOURCE FILE LOCATION:
  54.         X:\ibmcpp\samples\ioc\hello6
  55.  
  56.         where X: is the drive you installed the samples and document
  57.         component of VisualAge C++.
  58.  
  59.    HOW TO RUN THE SAMPLE:
  60.  
  61.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  62.              To run the prebuilt project, open the Samples folder on your
  63.              OS/2 desktop then double-click on the project's icon to open
  64.              the project view of the sample.  Click on the RUN button of
  65.              the project's toolbar.
  66.  
  67.         FROM THE COMMAND LINE:
  68.              Simply type the name of the .EXE file, that is:
  69.  
  70.                  HELLO6
  71.  
  72.              If the sample fails to execute or abnormally ends, you can
  73.              get more information about the failure by turning on the
  74.              ICLUI trace.  This is done by setting the environment
  75.              variable ICLUI_TRACE as follows:
  76.  
  77.                    set ICLUI_TRACE=ON
  78.                    set ICLUI_TRACETO=STDERR
  79.  
  80.              The second export controls where the trace information is
  81.              reported.  With tracing turned on, ICLUI exception text will
  82.              be written to a standard error file. For example:
  83.  
  84.                    hello1 >hello1.out 2>&1
  85.  
  86.              The exception data is now in the file hello1.out.
  87.  
  88.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  89.  
  90.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  91.              Open the Samples folder on your OS/2 desktop then
  92.              double-click on the project's icon to open the project view
  93.              of the sample. In the upper half of the project window you
  94.              will see the icons of the files associated with the sample.
  95.              From the Project pulldown, select Build -> Rebuild All.  To
  96.              run the sample project, see HOW TO RUN THE SAMPLE PROJECT 
  97.              above.
  98.  
  99.         FROM THE COMMAND LINE:
  100.           -  A command file is provided to allow rebuilding of the
  101.              WorkFrame projects from the command line.  Simply type:
  102.  
  103.                  BUILD
  104.  
  105.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT 
  106.              above.
  107.  
  108.            - The sample application can also be built by entering:
  109.                  NMAKE
  110.              with no options while in the directory containing the
  111.              sample application files.  The makefile is named
  112.                  Makefile
  113.              To clean up the files generated from running make, enter:
  114.                  NMAKE CLEAN 
  115.              while in the directory containing the sample program files. 
  116.  
  117.    SOFTWARE/HARDWARE PREREQUISITES:
  118.  
  119.         o   IBM VisualAge C++
  120.         o   OS/2 2.1 or Warp
  121.         o   IBM or compatible 386 and up.
  122.  
  123.    ADDITIONAL INFORMATION:
  124.  
  125.         o   For more information on the creation and use of projects in
  126.             the WorkFrame environment, see the VisualAge C++ for OS/2
  127.             User's Guide.
  128.         o   For more information on the User Interface Classes, see the
  129.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  130.  
  131.         Both books can be found online.  To access an online book, simply
  132.         open the main VisualAge C++ desktop folder, then open the
  133.         Information Folder inside.  To view a book, double-click on that
  134.         book's icon.
  135.  
  136.  
  137.  
  138.    REQUIRED FILES - HELLO6:
  139.  
  140.    README
  141.         description and instructions for sample
  142.  
  143.    BUILD.CMD
  144.         command file for building in project form from the command file
  145.  
  146.    HELLO6.EXE
  147.         sample's executable file
  148.  
  149.    AHELLOW6.CPP
  150.         C++  Source code for main() and AHelloWindow class
  151.  
  152.    AHELLOW6.HPP
  153.         Class header file for AHellowWindow 
  154.  
  155.    AHELLOW6.H
  156.         Symbolic definition file 
  157.  
  158.    AHELLOW6.RC
  159.         resource file
  160.  
  161.    AHELLOW6.ICO
  162.         icon file
  163.  
  164.    AHELLOW6.IPF
  165.         tagged help file source
  166.  
  167.    AHELLOW6.HLP
  168.         compiled help file
  169.  
  170.    HELLO6_H
  171.  
  172.    AEARTHW6.CPP
  173.         Source code for AEarthWindow class
  174.   
  175.    AEARTHW6.HPP
  176.         Class header file for AEarthWindow
  177.  
  178.    ADIALOG6.CPP
  179.         Source code for ATextDialog class
  180.  
  181.    ADIALOG6.HPP
  182.         Class header file for ATextDialog
  183.  
  184.    ANOTEBW6.CPP
  185.         Source code for ANotebookWindow class
  186.  
  187.    ANOTEBW6.HPP
  188.         Class header file for ANotebookWindow
  189.  
  190.    ATIMEHDR.CPP
  191.         Source code for ATimeHandler class 
  192.    ATIMEHDR.HPP
  193.         Class header file for ATimeHandler
  194.  
  195.    MAKEFILE
  196.         make file to build the sample program
  197.  
  198.