home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / MCELCV / README < prev   
Text File  |  1995-06-09  |  6KB  |  138 lines
  1. ******************************************************************************
  2. * Canvas Classes Example 3 - Multi Cell Canvas                               *
  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. * NOTE: WE RECOMMEND USING A FIXED SPACE FONT TO LOOK AT THE SOURCE          *
  16.  
  17. MULTI-CELL CANVAS
  18.  
  19.    DESCRIPTION:
  20.  
  21.         The Multi Cell Canvas Sample illustrates placement of UI objects
  22.         on the IMultiCellCanvas.  In addition, pressing the READ button
  23.         demonstrates which check boxes and radio buttons are selected.
  24.         Classed used include IMultiCellCanvas, ICheckBox, IRadioButton,
  25.         and IPushButton.
  26.  
  27.    FEATURES/CONCEPTS:
  28.        run the current application
  29.        create a main window
  30.        create a multi cell canvas and use as client area
  31.        one row and one column are expandable                                     
  32.        all other controls attached to canvas
  33.        create static text controls
  34.        control cursor and tab movement between different groups
  35.        process 'Command' events generated by the push button
  36.        create check boxes, radio buttons and push buttons 
  37.        load strings from resource bound to the exe
  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\mcelcv
  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.                  MCELCV
  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.  
  127.  
  128.    REQUIRED FILES - MCELCV:
  129.                                                               
  130.      README        - Readme file for MCELCV                                
  131.      amcelcv.cpp   - Source code for MCELCV                                
  132.      amcelcv.hpp   - Class header file form MCELCV                         
  133.      amcelcv.h     - Defines for MCELCV                                    
  134.      amcelcv.rc    - Resource File for MCELCV                              
  135.      amcelcv.ico   - OS/2 icon file                                        
  136.      Makefile      - Make file to build sample program                     
  137.  
  138.