home *** CD-ROM | disk | FTP | other *** search
/ Power GUI Programming with VisualAge C++ / powergui.iso / trialva / ibmcppw / samples / ioc / hello5 / readme.txt < prev   
Encoding:
Text File  |  1996-02-22  |  3.8 KB  |  104 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. Hello World Sample 5
  15.  
  16.   DESCRIPTION:
  17.     Version 5 greatly increases the
  18.     functionality of the sample by adding a
  19.     listbox and graphics window to the client
  20.     area of the main frame window. The listbox
  21.     is used to display a "Hello World" in
  22.     different languages.  A select handler is
  23.     used to update the static text with
  24.     whatever "Hello World" string is selected
  25.     from the listbox. The graphics window uses
  26.     IOC:UI graphics to display a view of
  27.     the earth from space. The client area is
  28.     layed-out using ISplitCanvas objects to
  29.     allow the user to specify proportions for
  30.     the sections.
  31.  
  32.     Hello5 also introduces the use of the
  33.     IHelpWindow class for providing
  34.     context-specific application help.  The use
  35.     of IPF formatted information source files,
  36.     RTP formatted information source files,
  37.     and resource file help tables is also
  38.     demonstrated.
  39.  
  40.   CONCEPT/FEATURE:
  41.     Sample program with frame window, menu bar from
  42.     resource, information area, accelerator resources,
  43.     dialog window, listbox, graphics, split-canvas,
  44.     and help.
  45.  
  46.   HOW TO BUILD THE PROJECT FROM THE COMMAND LINE:
  47.     For building the sample using RTF help,
  48.     from within the directory containing the sample, simply type:
  49.          NMAKE
  50.  
  51.     For building the sample using IPF help,
  52.     from within the directory containing the sample, simply type:
  53.          NMAKE USE_IPF=1
  54.  
  55.   HOW TO BUILD THE PROJECT FROM WITHIN THE WORKFRAME ENVIRONMENT:
  56.     Refer to the standard Workframe BUILD instructions
  57.  
  58.   HOW TO RUN THE PROJECT FROM THE COMMAND LINE:
  59.     From within the directory containing the sample, simply type
  60.     the name of the executable:
  61.          HELLO5
  62.  
  63.   HOW TO RUN THE PROJECT FROM WITHIN THE WORKFRAME ENVIRONMENT:
  64.     Note: This sample uses IHelp and thus requires headers in the SDK.
  65.  
  66.     Refer to the standard Workframe RUN instructions
  67.  
  68.   SPECIAL NOTES:
  69.     If the sample fails to execute or
  70.     abnormally ends, you can get
  71.     more information about the failure
  72.     by turning on the ICLUI trace.
  73.     This is done by setting the
  74.     environment variable ICLUI_TRACE
  75.     as follows:
  76.  
  77.         set ICLUI_TRACE=ON
  78.         set ICLUI_TRACETO=STDERR
  79.  
  80.     ICLUI_TRACETO controls where
  81.     the trace information is reported.
  82.     With tracing turned on, ICLUI
  83.     exception text will be written to a
  84.     standard error file. For example:
  85.  
  86.         sample >sample.out 2>&1
  87.  
  88.     The exception data is now in the file
  89.     'sample.out'.
  90.  
  91.   ADDITIONAL HARDWARE/SOFTWARE REQUIREMENTS:
  92.     This sample refers to help identifiers and thus
  93.     requires headers in the SDK.
  94.  
  95.   VISUALAGE FOR C++ SAMPLES INFORMATION:
  96.     A complete listing of samples shipped with the VisualAge for C++
  97.     product can be found in the online GUIDE TO SAMPLES.  To access
  98.     this notebook, simply:
  99.  
  100.     -  Open the VISUALAGE FOR C++ program group in the Program
  101.        Manager window, then
  102.     -  Open the GUIDE TO SAMPLES notebook in the program group.
  103.  
  104.