home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / MSGBOX / README < prev   
Text File  |  1995-06-07  |  5KB  |  118 lines
  1. ***************************************************************************
  2. * FILE NAME: readme            (Message Box Sample Program)               *
  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.  
  17. MESSAGE BOX
  18.  
  19.    DESCRIPTION:
  20.  
  21.         The msgbox sample shows seven types of message boxes and the
  22.         responses that result from their use.  The results are displayed
  23.         in a read-only IMultiLineEdit control.  As you interact with the
  24.         message boxes, the MLE is updated with text indicating your
  25.         selection.  After viewing the last message box, you can scroll
  26.         the MLE or resize it to see how the word wrap style causes the
  27.         automatic reflow of text.
  28.  
  29.    PROJECT LOCATION:
  30.         Inside the IOC Samples folder (inside the VisualAge C++ Samples
  31.         folder).
  32.  
  33.    SOURCE FILE LOCATION:
  34.         X:\ibmcpp\samples\ioc\msgbox
  35.  
  36.         where X: is the drive you installed the samples and document
  37.         component of VisualAge C++.
  38.  
  39.    HOW TO RUN THE SAMPLE:
  40.  
  41.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  42.              To run the prebuilt project, open the Samples folder on your
  43.              OS/2 desktop then double-click on the project's icon to open
  44.              the project view of the sample.  Click on the RUN button of
  45.              the project's toolbar.
  46.  
  47.         FROM THE COMMAND LINE:
  48.              Simply type the name of the .EXE file, that is:
  49.  
  50.                  MSGBOX
  51.  
  52.              If the sample fails to execute or abnormally ends, you can
  53.              get more information about the failure by turning on the
  54.              ICLUI trace.  This is done by setting the environment
  55.              variable ICLUI_TRACE as follows:
  56.  
  57.                    set ICLUI_TRACE=ON
  58.                    set ICLUI_TRACETO=STDERR
  59.  
  60.              The second export controls where the trace information is
  61.              reported.  With tracing turned on, ICLUI exception text will
  62.              be written to a standard error file. For example:
  63.  
  64.                    hello1 >hello1.out 2>&1
  65.  
  66.              The exception data is now in the file hello1.out.
  67.  
  68.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  69.  
  70.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  71.              Open the Samples folder on your OS/2 desktop then
  72.              double-click on the project's icon to open the project view
  73.              of the sample. In the upper half of the project window you
  74.              will see the icons of the files associated with the sample.
  75.              From the Project pulldown, select Build -> Rebuild All. To run
  76.              the sample project, see HOW TO RUN THE SAMPLE PROJECT above.
  77.  
  78.         FROM THE COMMAND LINE:
  79.              A command file is provided to allow rebuilding of the
  80.              WorkFrame projects from the command line.  Simply type:
  81.  
  82.                  BUILD
  83.  
  84.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT 
  85.              above.
  86.  
  87.  
  88.    SOFTWARE/HARDWARE PREREQUISITES:
  89.  
  90.         o   IBM VisualAge C++
  91.         o   OS/2 2.1 or Warp
  92.         o   IBM or compatible 386 and up.
  93.  
  94.    ADDITIONAL INFORMATION:
  95.  
  96.         o   For more information on the creation and use of projects in
  97.             the WorkFrame environment, see the VisualAge C++ for OS/2
  98.             User's Guide.
  99.         o   For more information on the User Interface Classes, see the
  100.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  101.  
  102.         Both books can be found online.  To access an online book, simply
  103.         open the main VisualAge C++ desktop folder, then open the
  104.         Information Folder inside.  To view a book, double-click on that
  105.         book's icon.
  106.  
  107.  
  108.   REQUIRED FILES - MSGBOX: 
  109.                                                      *
  110.    README       - Instructions for using this sample program             
  111.    msgbox.cpp   - Source code for main() and AMsgBoxDemo class           
  112.    msgbox.hpp   - Class header file for AMsgBoxDemo                      
  113.    msgbox.h     - Symbolic definition file                               
  114.    msgbox.rc    - OS/2 PM resource file                                  
  115.    msgbox.ipf   - Information Presentation Facility help file source     
  116.    msgbox.hlp   - IPF file generated from msgbox.ipf (ipfc)              
  117.    Makefile     - Make file to build the sample program                  
  118.