home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / DRAG2 / README < prev   
Text File  |  1995-06-07  |  6KB  |  154 lines
  1. **********************************************************************
  2. * Direct Manipulation Sample 2 - Readme file                                   
  3. *                                                                              
  4. * COPYRIGHT:                                                                   
  5. *   IBM Open Class Library                                                       
  6. *   (C) Copyright International Business Machines Corporation 1992, 1995       
  7. *   Licensed Material - Program-Property of IBM - All Rights Reserved. 
  8. *   US Government Users Restricted Rights - Use, duplication, or disclosure  
  9. *   restricted by GSA ADP Schedule Contract with IBM Corp.
  10. *            
  11. * DISCLAIMER OF WARRANTIES:
  12. *   The following [enclosed] code is sample code created by IBM           
  13. *   Corporation.  This sample code is not part of any standard IBM product
  14. *   and is provided to you solely for the purpose of assisting you in the 
  15. *   development of your applications.  The code is provided "AS IS",      
  16. *   without warranty of any kind.  IBM shall not be liable for any damages
  17. *   arising out of your use of the sample code, even if they have been    
  18. *   advised of the possibility of such damages.                           
  19. **********************************************************************
  20.                                                     
  21. SAMPLE - DRAG2
  22.  
  23.    DESCRIPTION:
  24.  
  25.         The Direct Manipulation Sample 2 demonstrates dragging and
  26.         dropping bitmap objects.  By opening a system folder or group,
  27.         you can drag a bitmap file representation onto the sample.  The
  28.         sample will then determine the file name and display the bitmap
  29.         in the client area.  Classes used are IDMItem,
  30.         IDMItemProviderFor, IBitmapControl, IGBitmap, IGraphicContext,
  31.         IGraphicBundle, and IGRectangle.
  32.  
  33.    CONCEPT/FEATURE:
  34.         Sample program for demonstrating DRAG2
  35.  
  36.    PROJECT LOCATION:
  37.         Inside the IOC Samples folder (which is inside the VisualAge C++
  38.         Samples folder).
  39.  
  40.    SOURCE FILE LOCATION:
  41.         X:\ibmcpp\samples\ioc\drag2
  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.                  DRAG2
  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 run
  83.              the sample project, see HOW TO RUN THE SAMPLE PROJECT above.
  84.  
  85.         FROM THE COMMAND LINE:
  86.            - A command file is provided to allow rebuilding of the
  87.              WorkFrame projects from the command line.  Simply type:
  88.  
  89.                  BUILD
  90.  
  91.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT 
  92.              above.
  93.  
  94.           - The sample application can also be built by entering:
  95.                  NMAKE
  96.              with no options while in the directory containing the
  97.              sample application files.  The makefile is named
  98.                  Makefile
  99.              To clean up the files generated from running make, enter:
  100.                  NMAKE CLEAN 
  101.              while in the directory containing the sample program files
  102.  
  103.    SOFTWARE/HARDWARE PREREQUISITES:
  104.  
  105.         o   IBM VisualAge C++
  106.         o   OS/2 2.1 or Warp
  107.         o   IBM or compatible 386 and up.
  108.  
  109.    ADDITIONAL INFORMATION:
  110.  
  111.         o   For more information on the creation and use of projects in
  112.             the WorkFrame environment, see the VisualAge C++ for OS/2
  113.             User's Guide.
  114.         o   For more information on the User Interface Classes, see the
  115.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  116.  
  117.         Both books can be found online.  To access an online book, simply
  118.         open the main VisualAge C++ desktop folder, then open the
  119.         Information Folder inside.  To view a book, double-click on that
  120.         book's icon.
  121.  
  122.  
  123.    REQUIRED FILES - DRAG2:
  124.  
  125.      README
  126.         Instructions for using this sample program
  127.  
  128.      BUILD.CMD
  129.         command file for building sample in project form from command
  130.         line
  131.  
  132.      DRAG2.EXE
  133.         sample's executable
  134.  
  135.      DMSAMP2.CPP
  136.         Source code for DRAG2
  137.  
  138.      DMSAMP2.HPP
  139.         Class definition for DRAG2
  140.  
  141.      DMSAMP2.H
  142.         symbolic definitions
  143.  
  144.      DMSAMP2.ICO
  145.         icon file
  146.  
  147.      DMSAMP2.RC
  148.         resource file
  149.  
  150.      MAKEFILE
  151.         Make file to build the sample program on OS/2
  152.  
  153.  
  154.