home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / TBAR2 / README < prev    next >
Text File  |  1995-06-09  |  6KB  |  136 lines
  1. ***************************************************************************
  2. * FILE NAME: readme            (Tool Bar Sample Program 2)                *
  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. TOOLBAR2
  17.  
  18.    DESCRIPTION:
  19.  
  20.         The Tool Bar Sample 2 demonstrates multiple toolbars and direct
  21.         manipulation (ie. drag/drop) of toolbars and toolbar buttons
  22.         within a simple editor.  The File toolbar, Cut/Copy/Paste Edit
  23.         toolbar, and the Font toolbar locations and attributes can be
  24.         modified in the Toolbar notebook under the Options menu item.
  25.         Toolbar buttons appear as bitmaps, bitmaps and text, or just
  26.         text.  In addition, a toolbar can be positioned on top, bottom,
  27.         left, right, free floating, or hidden.  Toolbars can be dragged
  28.         to new locations within the application or dragged outside the
  29.         application to create a free floating toolbar.  Toolbar buttons
  30.         can also be dragged to reorder the buttons in a toolbar, move the
  31.         button to a different toolbar, or delete the button from the
  32.         toolbar.  The File and Edit menu items can also be dragged to a
  33.         toolbar and a representative toolbar button is created.  Classed
  34.         used include IToolBar, IToolBarButton, IFlyText,
  35.         IFlyOverHelpHandler, and IMultiLineEdit.
  36.  
  37.    PROJECT LOCATION:
  38.         Inside the IOC Samples folder (inside the VisualAge C++ Samples
  39.         folder). 
  40.  
  41.    SOURCE FILE LOCATION:
  42.         X:\ibmcpp\samples\ioc\tbar2
  43.  
  44.         where X: is the drive you installed the samples and document
  45.         component of VisualAge C++.
  46.  
  47.    HOW TO RUN THE SAMPLE:
  48.  
  49.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  50.              To run the prebuilt project, open the Samples folder on your
  51.              OS/2 desktop then double-click on the project's icon to open
  52.              the project view of the sample.  Click on the RUN button of
  53.              the project's toolbar.
  54.  
  55.         FROM THE COMMAND LINE:
  56.              Simply type the name of the .EXE file, that is:
  57.  
  58.                  TBAR2
  59.  
  60.              If the sample fails to execute or abnormally ends, you can
  61.              get more information about the failure by turning on the
  62.              ICLUI trace.  This is done by setting the environment
  63.              variable ICLUI_TRACE as follows:
  64.  
  65.                    set ICLUI_TRACE=ON
  66.                    set ICLUI_TRACETO=STDERR
  67.  
  68.              The second export controls where the trace information is
  69.              reported.  With tracing turned on, ICLUI exception text will
  70.              be written to a standard error file. For example:
  71.  
  72.                    hello1 >hello1.out 2>&1
  73.  
  74.              The exception data is now in the file hello1.out.
  75.  
  76.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  77.  
  78.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  79.              Open the Samples folder on your OS/2 desktop then
  80.              double-click on the project's icon to open the project view
  81.              of the sample. In the upper half of the project window you
  82.              will see the icons of the files associated with the sample.
  83.              From the Project pulldown, select Build -> Rebuild All. To run
  84.              the sample project, see HOW TO RUN THE SAMPLE PROJECT 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.    SOFTWARE/HARDWARE PREREQUISITES:
  105.  
  106.         o   IBM VisualAge C++
  107.         o   OS/2 2.1 or Warp
  108.         o   IBM or compatible 386 and up.
  109.  
  110.    ADDITIONAL INFORMATION:
  111.  
  112.         o   For more information on the creation and use of projects in
  113.             the WorkFrame environment, see the VisualAge C++ for OS/2
  114.             User's Guide.
  115.         o   For more information on the User Interface Classes, see the
  116.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  117.  
  118.         Both books can be found online.  To access an online book, simply
  119.         open the main VisualAge C++ desktop folder, then open the
  120.         Information Folder inside.  To view a book, double-click on that
  121.         book's icon.
  122.  
  123.  
  124.  
  125.  REQUIRED FILES - TBAR2:
  126.                                                       
  127.    README       - Instructions for using this sample program             
  128.    tbar2.cpp    - Source code for samples class                          
  129.    tbar2.hpp    - Class header file for sample class                     
  130.    tbar2.h      - Symbolic definition file                               
  131.    tbar2.rc     - OS/2 PM resource file                                  
  132.    tbar2.ico    - OS/2 icon file                                         
  133.    Makefile     - Make file to build the sample program                  
  134.    toolbar2.not - note file loaded by the sample program on OS/2         
  135.  
  136.