home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / VPORT / README < prev    next >
Text File  |  1995-06-09  |  6KB  |  135 lines
  1. **************************************************************************
  2. * Canvas Classes Example 4 - ViewPort Readme                                 *
  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.  
  18. VIEWPORT
  19.  
  20.    DESCRIPTION:
  21.  
  22.         The View Port Sample illustrates the viewport's ability to scroll
  23.         the client window that is not completely visible due to its size.
  24.         This viewport scrolls a bitmap that is too large for the client
  25.         area.  Classes used include IViewPort and IBitmapControl.
  26.  
  27.    CONCEPT/FEATURE:
  28.         Key functions:
  29.         - create a main window
  30.         - run the current application
  31.         - create a viewport and use a client area
  32.         - create a bitmap control
  33.         - load the bitmap from resource bound to the executable
  34.         - load strings from resource bound to the executable
  35.  
  36.    PROJECT LOCATION:
  37.         Inside the IOC Samples folder (inside the VisualAge C++ Samples
  38.         folder) 
  39.  
  40.    SOURCE FILE LOCATION:
  41.         X:\ibmcpp\samples\ioc\vport
  42.  
  43.         where X: is the drive you installed the samples and document
  44.         component of VisualAge C++.
  45.  
  46.    HOW TO RUN THE SAMPLE:
  47.  
  48.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  49.              To run the prebuilt project, open the Samples folder on your
  50.              OS/2 desktop then double-click on the project's icon to open
  51.              the project view of the sample.  Click on the RUN button of
  52.              the project's toolbar.
  53.  
  54.         FROM THE COMMAND LINE:
  55.              Simply type the name of the .EXE file, that is:
  56.  
  57.                  VPORT
  58.  
  59.              If the sample fails to execute or abnormally ends, you can
  60.              get more information about the failure by turning on the
  61.              ICLUI trace.  This is done by setting the environment
  62.              variable ICLUI_TRACE as follows:
  63.  
  64.                    set ICLUI_TRACE=ON
  65.                    set ICLUI_TRACETO=STDERR
  66.  
  67.              The second export controls where the trace information is
  68.              reported.  With tracing turned on, ICLUI exception text will
  69.              be written to a standard error file. For example:
  70.  
  71.                    hello1 >hello1.out 2>&1
  72.  
  73.              The exception data is now in the file hello1.out.
  74.  
  75.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  76.  
  77.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  78.              Open the Samples folder on your OS/2 desktop then
  79.              double-click on the project's icon to open the project view
  80.              of the sample. In the upper half of the project window you
  81.              will see the icons of the files associated with the sample.
  82.              From the Project pulldown, select Build -> Rebuild All.  To 
  83.              run the sample project, see HOW TO RUN THE SAMPLE PROJECT
  84.              above.
  85.  
  86.         FROM THE COMMAND LINE:
  87.           -  A command file is provided to allow rebuilding of the
  88.              WorkFrame projects from the command line.  Simply type:
  89.  
  90.                  BUILD
  91.  
  92.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT 
  93.              above.
  94.  
  95.            - The sample application can also be built by entering:
  96.                  NMAKE
  97.              with no options while in the directory containing the
  98.              sample application files.  The makefile is named
  99.                  Makefile
  100.              To clean up the files generated from running make, enter:
  101.                  NMAKE CLEAN 
  102.              while in the directory containing the sample program files. 
  103.  
  104.  
  105.    SOFTWARE/HARDWARE PREREQUISITES:
  106.  
  107.         o   IBM VisualAge C++
  108.         o   OS/2 2.1 or Warp
  109.         o   IBM or compatible 386 and up.
  110.  
  111.    ADDITIONAL INFORMATION:
  112.  
  113.         o   For more information on the creation and use of projects in
  114.             the WorkFrame environment, see the VisualAge C++ for OS/2
  115.             User's Guide.
  116.         o   For more information on the User Interface Classes, see the
  117.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  118.  
  119.         Both books can be found online.  To access an online book, simply
  120.         open the main VisualAge C++ desktop folder, then open the
  121.         Information Folder inside.  To view a book, double-click on that
  122.         book's icon.
  123.  
  124.  
  125.  
  126.  REQUIRED FILES:
  127.                                                             
  128.    README       - Readme file for VPORT                                  
  129.    avport.cpp   - Source code for VPORT                                  
  130.    avport.hpp   - Class header file form VPORT                           
  131.    avport.h     - Defines for VPORT                                      
  132.    avport.rc    - Resource File for VPORT                                
  133.    avport.ico   - OS/2 icon file                                         
  134.    Makefile     - Make file to create VPORT                              
  135.