home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / LANCELOT / README < prev    next >
Text File  |  1995-06-09  |  12KB  |  205 lines
  1. ***************************************************************************
  2. * LANCELOT Sample Program - Readme file                                   *
  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. LANCELOT
  17.  
  18.    DESCRIPTION:
  19.  
  20.         Lancelot is a complex sample intended to represent a typical
  21.         customer application.  Lancelot is a tool for tracking employees,
  22.         employee time cards, and business projects.  The main window is
  23.         the launching point for employee queries.  Actions appear on the
  24.         menu bar, toolbar, and container object popup menus.  After
  25.         filling in query criteria in the Query Personnel notebook, a
  26.         container with employees matching your search criteria appears.
  27.         Actions also appear on the menu bar, toolbar, and employee object
  28.         popup menus.  Specific employee information appears when opening
  29.         the employee.  Lancelot uses many User Interface classes.  Just a
  30.         few of these include IFrameWindow, IMenuBar, Infoarea, IHelp,
  31.         IFont, IResourceLibrary, IContainerControl, IContainerObject,
  32.         IPopupMenu, INotebook, IMultiCellCanvas, ISetCanvas, IProfile,
  33.         IEntryField, IPushButton, IGraphicPushButton, INumericSpinButton,
  34.         IComboBox, ICheckBox, IMenuBar, ITitle, IString, ICommandHandler,
  35.         ICnrHandler, ICnrMenuHandler, IToolBar, IToolBarButton,
  36.         IFlyOverHelp, IFlyOverHelpHandler, IGPie, IGRectangle, IGString,
  37.         and Direct Manipulation (i.e. Drag/Drop).
  38.  
  39.    PROJECT LOCATION:
  40.         Inside the IOC Samples folder (inside the VisualAge C++ Samples
  41.         folder). 
  42.  
  43.    SOURCE FILE LOCATION:
  44.         X:\ibmcpp\samples\ioc\lancelot
  45.  
  46.         where X: is the drive you installed the samples and document
  47.         component of VisualAge C++.
  48.  
  49.    HOW TO RUN THE SAMPLE:
  50.  
  51.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  52.              To run the prebuilt project, open the Samples folder on your
  53.              OS/2 desktop then double-click on the project's icon to open
  54.              the project view of the sample.  Click on the RUN button of
  55.              the project's toolbar.
  56.  
  57.         FROM THE COMMAND LINE:
  58.              Simply type the name of the .EXE file, that is:
  59.  
  60.                  LANCELOT
  61.  
  62.              If the sample fails to execute or abnormally ends, you can
  63.              get more information about the failure by turning on the
  64.              ICLUI trace.  This is done by setting the environment
  65.              variable ICLUI_TRACE as follows:
  66.  
  67.                    set ICLUI_TRACE=ON
  68.                    set ICLUI_TRACETO=STDERR
  69.  
  70.              The second export controls where the trace information is
  71.              reported.  With tracing turned on, ICLUI exception text will
  72.              be written to a standard error file. For example:
  73.  
  74.                    hello1 >hello1.out 2>&1
  75.  
  76.              The exception data is now in the file hello1.out.
  77.  
  78.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  79.  
  80.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  81.              Open the Samples folder on your OS/2 desktop then
  82.              double-click on the project's icon to open the project view
  83.              of the sample. In the upper half of the project window you
  84.              will see the icons of the files associated with the sample.
  85.              From the Project pulldown, select Build -> Rebuild All. To run
  86.              the sample project, see HOW TO RUN THE SAMPLE PROJECT above.
  87.  
  88.         FROM THE COMMAND LINE:
  89.            - A command file is provided to allow rebuilding of the
  90.              WorkFrame projects from the command line.  Simply type:
  91.  
  92.                  BUILD
  93.  
  94.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT 
  95.              above.
  96.  
  97.            - The sample application can also be built by entering:
  98.                  NMAKE
  99.              with no options while in the directory containing the
  100.              sample application files.  The makefile is named
  101.                  Makefile
  102.              To clean up the files generated from running make, enter:
  103.                  NMAKE CLEAN 
  104.              while in the directory containing the sample program files. 
  105.  
  106.    SOFTWARE/HARDWARE PREREQUISITES:
  107.  
  108.         o   IBM VisualAge C++
  109.         o   OS/2 2.1 or Warp
  110.         o   IBM or compatible 386 and up.
  111.  
  112.    ADDITIONAL INFORMATION:
  113.  
  114.         o   For more information on the creation and use of projects in
  115.             the WorkFrame environment, see the VisualAge C++ for OS/2
  116.             User's Guide.
  117.         o   For more information on the User Interface Classes, see the
  118.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  119.  
  120.         Both books can be found online.  To access an online book, simply
  121.         open the main VisualAge C++ desktop folder, then open the
  122.         Information Folder inside.  To view a book, double-click on that
  123.         book's icon.
  124.  
  125.  
  126.  REQUIRED FILES - LANCELOT                                                       *
  127.  -----------------                                                       
  128.    readme       - Instructions for using this sample program             
  129.    lacct.cpp    - Source code for the Account Page                       
  130.    lacct.hpp    - Class definition for the Account Page                  
  131.    lancelot.cpp - Source code for main()                                 
  132.    lbadge.cpp   - Source code for the Badge Page                         
  133.    lbadge.hpp   - Class definition for the Badge Page                    
  134.    lcnrobj.cpp  - Source code for the container objects                  
  135.    lcnrobj.hpp  - Class definition for container objects                 
  136.    ldbase.cpp   - Source code for the database      (DO NOT EVEN LOOK)   
  137.    ldbase.hpp   - Class definition for the database (DO NOT EVEN LOOK)   
  138.    ldbqry.cpp   - Source code for the database      (DO NOT EVEN LOOK)   
  139.    ldbqry.hpp   - Class definition for the database (DO NOT EVEN LOOK)   
  140.    lentry.hpp   - Class definition for an entry in a collection          
  141.    lgeneric.cpp - Source code for generic functions                      
  142.    lgeneric.hpp - Class definition for generic functions                 
  143.    lgenl.cpp    - Source code for the General Page                       
  144.    lgenl.hpp    - Class definition for General Page                      
  145.    lgoodies.cpp - Source code for some goody functions                  
  146.    lgoodies.hpp - Class definition for some goody functions              
  147.    linfonb.cpp  - Source code for the Information Notebook               
  148.    linfonb.hpp  - Class definition for the Information Notebook          
  149.    linfowin.cpp - Source code for the Information Window                 
  150.    linfowin.hpp - Class definition for the Information Window            
  151.    litems.hpp   - Class definition for page data items in a collection   
  152.    lmainwin.cpp - Source code for the Main Window                        
  153.    lmainwin.hpp - Class definition for the Main Window                   
  154.    lpagectl.cpp - Source code for generic notebook page controls         
  155.    lpagectl.hpp - Class definition for generic notebook page controls    
  156.    lperswdm.cpp - Source code for direct manipulation (drag/drop)        
  157.    lperswdm.hpp - Class definition for direct manipulation (drag/drop)   
  158.    lperswin.cpp - Source code for the Personnel Window                   
  159.    lperswin.hpp - Class definition for the Personnel Window              
  160.    lproject.cpp - Source code for the Project Page                       
  161.    lproject.hpp - Class definition for the Project Page                 
  162.    lskill.cpp   - Source code for the Skill Page                         
  163.    lskill.hpp   - Class definition for the Skill Page                    
  164.    lstatus.cpp  - Source code for the Status Page                        
  165.    lstatus.hpp  - Class definition for the Status Page                   
  166.    ltask.cpp    - Source code for the Task Page                          
  167.    ltask.hpp    - Class definition for the Task Page                     
  168.    ltimec.cpp   - Source code for the the TimeCard Page                  
  169.    ltimec.hpp   - Class definition for the TimeCard Page                 
  170.    ltimepie.cpp - Source code for the TimeCard Pie Chart                 
  171.    ltimepie.hpp - Class definition for TimeCard Pie Chart                
  172.    lancelot.h   - Symbolic definition file                              
  173.    lancelot.rc  - OS/2 resource file                                     
  174.    lancelot.ipf - IPF source code for online guide                       
  175.    lanchelp.ipf - IPF source code for online help                        
  176.    add.ico      - OS/2 icon resource                                    
  177.    change.ico   - OS/2 icon resource                                     
  178.    help.ico     - OS/2 icon resource                                     
  179.    lancelot.ico - OS/2 icon resource                                    
  180.    next.ico     - OS/2 icon resource                                     
  181.    person1.ico  - OS/2 icon resource                                     
  182.    person2.ico  - OS/2 icon resource                                    
  183.    person3.ico  - OS/2 icon resource                                     
  184.    person4.ico  - OS/2 icon resource                                     
  185.    personu.ico  - OS/2 icon resource                                     
  186.    previous.ico - OS/2 icon resource                                    
  187.    query.ico    - OS/2 icon resource                                     
  188.    query2.ico   - OS/2 icon resource                                     
  189.    remove.ico   - OS/2 icon resource                                    
  190.    save.ico     - OS/2 icon resource                                     
  191.    undo.ico     - OS/2 icon resource                                     
  192.    arrange.bmp  - OS/2 bitmap resource                                   
  193.    boot.bmp     - OS/2 bitmap resource                                   
  194.    create.bmp   - OS/2 bitmap resource                                   
  195.    deselall.bmp - OS/2 bitmap resource                                   
  196.    opendeta.bmp - OS/2 bitmap resource                                   
  197.    openicon.bmp - OS/2 bitmap resource                                   
  198.    opentree.bmp - OS/2 bitmap resource                                   
  199.    selall.bmp   - OS/2 bitmap resource                                  
  200.    sortasc.bmp  - OS/2 bitmap resource                                   
  201.    sortdesc.bmp - OS/2 bitmap resource                                   
  202.    transfer.bmp - OS/2 bitmap resource                                   
  203.    Makefile     - Make file to build the sample program                  
  204.                                                                          
  205.