home *** CD-ROM | disk | FTP | other *** search
/ Power GUI Programming with VisualAge C++ / powergui.iso / trialva / ibmcppw / samples / ioc / lancelot / readme.txt < prev    next >
Encoding:
Text File  |  1996-02-22  |  4.8 KB  |  130 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. Lancelot: A Valiant Example
  15.  
  16.   DESCRIPTION:
  17.     Lancelot is a complex sample intended to
  18.     represent a typical customer application.
  19.     Lancelot is a tool for tracking employees,
  20.     employee time cards, and business
  21.     projects. The main window is the launching
  22.     point for employee queries. Actions appear
  23.     on the menu bar, toolbar, and container
  24.     object popup menus.  After filling in query
  25.     criteria in the Query Personnel notebook, a
  26.     container with employees matching your
  27.     search criteria appears.  Actions also
  28.     appear on the menu bar, toolbar, and
  29.     employee object popup menus.  Specific
  30.     employee information appears when
  31.     opening the employee.
  32.  
  33.   CONCEPT/FEATURE:
  34.     Lancelot uses many
  35.     User Interface classes.  Just a few of
  36.     these include IFrameWindow, IMenuBar,
  37.     Infoarea, IHelp, IFont, IResourceLibrary,
  38.     IContainerControl, IContainerObject,
  39.     IPopupMenu, INotebook, IMultiCellCanvas,
  40.     ISetCanvas, IProfile, IEntryField,
  41.     IPushButton, IGraphicPushButton,
  42.     INumericSpinButton, IComboBox, ICheckBox,
  43.     IMenuBar, ITitle, IString, ICommandHandler,
  44.     ICnrHandler, ICnrMenuHandler, IToolBar,
  45.     IToolBarButton, IFlyOverHelp,
  46.     IFlyOverHelpHandler, IGPie, IGRectangle,
  47.     IGString, and Direct Manipulation (i.e.
  48.     Drag/Drop).
  49.  
  50.   HOW TO BUILD THE PROJECT FROM THE COMMAND LINE:
  51.     Note: This sample uses IHelp and thus requires headers in the SDK.
  52.  
  53.     For building the sample using RTF help,
  54.     from within the directory containing the sample, simply type:
  55.          NMAKE
  56.  
  57.     For building the sample using IPF help,
  58.     from within the directory containing the sample, simply type:
  59.          NMAKE USE_IPF=1
  60.  
  61.   HOW TO BUILD THE PROJECT FROM WITHIN THE WORKFRAME ENVIRONMENT:
  62.     Note: This sample uses IHelp and thus requires headers in the SDK.
  63.  
  64.     Refer to the standard Workframe BUILD instructions
  65.  
  66.   HOW TO RUN THE PROJECT FROM THE COMMAND LINE:
  67.     From within the directory containing the sample, simply type
  68.     the name of the executable:
  69.          LANCELOT
  70.  
  71.     Note:  When you run this application, data is stored into
  72.            the following .INI files:
  73.  
  74.                  LSAVEQRY.INI
  75.                  LBADGE.INI
  76.                  LEMPL.INI
  77.                  LACCT.INI
  78.                  LSKILL.INI
  79.                  LSTATUS.INI
  80.                  LPROJECT.INI
  81.                  LTASK.INI
  82.                  LTIME.INI
  83.  
  84.            However on Windows, data is stored in the Windows registry
  85.            HKEY_LOCAL_MACHINE/Software.  If you want to delete the
  86.            data, Microsoft provides a tool that allows you to
  87.            modify the Windows registry.
  88.  
  89.   HOW TO RUN THE PROJECT FROM WITHIN THE WORKFRAME ENVIRONMENT:
  90.     Refer to the standard Workframe RUN instructions
  91.  
  92.   SPECIAL NOTES:
  93.     If the sample fails to execute or
  94.     abnormally ends, you can get
  95.     more information about the failure
  96.     by turning on the ICLUI trace.
  97.     This is done by setting the
  98.     environment variable ICLUI_TRACE
  99.     as follows:
  100.  
  101.         set ICLUI_TRACE=ON
  102.         set ICLUI_TRACETO=STDERR
  103.  
  104.     ICLUI_TRACETO controls where
  105.     the trace information is reported.
  106.     With tracing turned on, ICLUI
  107.     exception text will be written to a
  108.     standard error file. For example:
  109.  
  110.         sample >sample.out 2>&1
  111.  
  112.     The exception data is now in the file
  113.     'sample.out'.
  114.  
  115.   ADDITIONAL HARDWARE/SOFTWARE REQUIREMENTS:
  116.     Lancelot is a large application which uses many resources
  117.     of the operating system.  Some Lancelot dialogs may not
  118.     appear on Windows 3.x because this operating system has
  119.     exhausted the limited resources.
  120.  
  121.   VISUALAGE FOR C++ SAMPLES INFORMATION:
  122.     A complete listing of samples shipped with the VisualAge for C++
  123.     product can be found in the online GUIDE TO SAMPLES.  To access
  124.     this notebook, simply:
  125.  
  126.     -  Open the VISUALAGE FOR C++ program group in the Program
  127.        Manager window, then
  128.     -  Open the GUIDE TO SAMPLES notebook in the program group.
  129.  
  130.