home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / DRAG3 / README < prev    next >
Text File  |  1995-06-09  |  6KB  |  167 lines
  1. ***********************************************************************
  2. * Direct Manipulation Sample 3 - 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. DRAG3
  22.  
  23.    DESCRIPTION:
  24.  
  25.         The Direct Manipulation Sample 3 demonstrates dragging container
  26.         objects from a source window to a target window.  The application
  27.         takes advantage of overriding the IContainerObject::objectCopy()
  28.         function.  Classed used included IDMHandler, IContainerControl,
  29.         and IContainerObject.
  30.  
  31.    CONCEPT/FEATURE:
  32.         Sample program for demonstrating DRAG3
  33.  
  34.    PROJECT LOCATION:
  35.         Inside the IOC Samples folder (inside the VisualAge C++ Samples 
  36.         folder)
  37.  
  38.    SOURCE FILE LOCATION:
  39.         X:\ibmcpp\samples\ioc\drag3
  40.  
  41.         where X: is the drive you installed the samples and document
  42.         component of VisualAge C++.
  43.  
  44.    HOW TO RUN THE SAMPLE:
  45.  
  46.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  47.              To run the prebuilt project, open the Samples folder on your
  48.              OS/2 desktop then double-click on the project's icon to open
  49.              the project view of the sample.  Click on the RUN button of
  50.              the project's toolbar.
  51.  
  52.         FROM THE COMMAND LINE:
  53.              Simply type the name of the .EXE file, that is:
  54.  
  55.                  DRAG3
  56.  
  57.              If the sample fails to execute or abnormally ends, you can
  58.              get more information about the failure by turning on the
  59.              ICLUI trace.  This is done by setting the environment
  60.              variable ICLUI_TRACE as follows:
  61.  
  62.                    set ICLUI_TRACE=ON
  63.                    set ICLUI_TRACETO=STDERR
  64.  
  65.              The second export controls where the trace information is
  66.              reported.  With tracing turned on, ICLUI exception text will
  67.              be written to a standard error file. For example:
  68.  
  69.                    hello1 >hello1.out 2>&1
  70.  
  71.              The exception data is now in the file hello1.out.
  72.  
  73.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  74.  
  75.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  76.              Open the Samples folder on your OS/2 desktop then
  77.              double-click on the project's icon to open the project view
  78.              of the sample. In the upper half of the project window you
  79.              will see the icons of the files associated with the sample.
  80.              From the Project pulldown, select Build -> Rebuild All.  To run
  81.              the sample project, see HOW TO RUN THE SAMPLE PROJECT above.
  82.  
  83.         FROM THE COMMAND LINE:
  84.            - A command file is provided to allow rebuilding of the
  85.              WorkFrame projects from the command line.  Simply type:
  86.  
  87.                  BUILD
  88.  
  89.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT 
  90.              above.
  91.  
  92.            - The sample application can also be built by entering:
  93.                  NMAKE
  94.              with no options while in the directory containing the
  95.              sample application files.  The makefile is named
  96.                  Makefile
  97.              To clean up the files generated from running make, enter:
  98.                  NMAKE CLEAN 
  99.              while in the directory containing the sample program files. 
  100.  
  101.    SOFTWARE/HARDWARE PREREQUISITES:
  102.  
  103.         o   IBM VisualAge C++
  104.         o   OS/2 2.1 or Warp
  105.         o   IBM or compatible 386 and up.
  106.  
  107.    ADDITIONAL INFORMATION:
  108.  
  109.         o   For more information on the creation and use of projects in
  110.             the WorkFrame environment, see the VisualAge C++ for OS/2
  111.             User's Guide.
  112.         o   For more information on the User Interface Classes, see the
  113.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  114.  
  115.         Both books can be found online.  To access an online book, simply
  116.         open the main VisualAge C++ desktop folder, then open the
  117.         Information Folder inside.  To view a book, double-click on that
  118.         book's icon.
  119.  
  120.  
  121.    SOURCE FILES - DRAG3
  122.  
  123.    README
  124.         Instructions for using this sample program
  125.  
  126.    BUILD.CMD
  127.         command file to build in project form from command line
  128.  
  129.    DRAG3.EXE
  130.         sample's executable
  131.  
  132.    DMSAMP3.CPP
  133.         Source code for DRAG3
  134.  
  135.    DMSAMP3.HPP
  136.         Class definition for DRAG3
  137.  
  138.    DMSAMP3.H
  139.         Symbolic definition file
  140.  
  141.    DMSAMP3.RC
  142.         OS/2 resource file
  143.  
  144.    APPLE.ICO
  145.         OS/2 icon resource
  146.  
  147.    BOLT.ICO
  148.         OS/2 icon resource
  149.  
  150.    CAR.ICO
  151.         OS/2 icon resource
  152.  
  153.    SPACE.ICO
  154.         OS/2 icon resource
  155.  
  156.    STARFLEE.ICO
  157.         OS/2 icon resource
  158.  
  159.    WIN100.ICO
  160.         OS/2 icon resource
  161.  
  162.    MAKEFILE.OS2
  163.         Make file to build the sample program on OS/2
  164.  
  165.  
  166.  
  167.