**********************************************************************
* DISCLAIMER OF WARRANTIES:                                          *
*                                                                    *
* The following enclosed code is sample code created by IBM          *
* Corporation.  This sample code is not part of any standard IBM     *
* product and is provided to you solely for the purpose of assisting *
* you in the development of your applications.  The code is provided *
* "AS IS", without warranty of any kind.  IBM shall not be liable    *
* for any damages arising out of your use of the sample code, even   *
* if they have been advised of the possibility of such damages       *
*                                                                    *
**********************************************************************

Tool Bar Sample 2

  DESCRIPTION:
    The Tool Bar Sample 2 demonstrates
    multiple toolbars and direct manipulation
    (ie. drag/drop OS/2 only) of toolbars and toolbar
    buttons within a simple editor.  The File
    toolbar, Cut/Copy/Paste Edit toolbar, and
    the Font toolbar locations and attributes
    can be modified in the Toolbar notebook
    under the Options menu item. Toolbar
    buttons appear as bitmaps, bitmaps and
    text, or just text. In addition, a toolbar can
    be positioned on top, bottom, left, right,
    free floating, or hidden. Toolbars can be
    dragged to new locations within the
    application or dragged outside the
    application to create a free floating toolbar.
    Under OS/2 only, toolbar buttons can also
    be dragged to reorder the buttons in a
    toolbar, move the button to a different
    toolbar, or delete the button from
    the toolbar. The File and Edit
    menu items can also be dragged to a
    toolbar and a representative toolbar button
    is created.

  CONCEPT/FEATURE:
    Sample program for demonstrating
    IToolBar, IToolBarButton, IFlyText,
    IFlyOverHelpHandler, and IMultiLineEdit.

  HOW TO BUILD THE PROJECT FROM THE COMMAND LINE:
    From within the directory containing the sample, simply type:
         NMAKE

  HOW TO BUILD THE PROJECT FROM WITHIN THE WORKFRAME ENVIRONMENT:
    Refer to the standard Workframe BUILD instructions

  HOW TO RUN THE PROJECT FROM THE COMMAND LINE:
    From within the directory containing the sample, simply type
    the name of the executable:
         TBAR2

  HOW TO RUN THE PROJECT FROM WITHIN THE WORKFRAME ENVIRONMENT:
    Refer to the standard Workframe RUN instructions

  SPECIAL NOTES:
    If the sample fails to execute or
    abnormally ends, you can get
    more information about the failure
    by turning on the ICLUI trace.
    This is done by setting the
    environment variable ICLUI_TRACE
    as follows:

        set ICLUI_TRACE=ON
        set ICLUI_TRACETO=STDERR

    ICLUI_TRACETO controls where
    the trace information is reported.
    With tracing turned on, ICLUI
    exception text will be written to a
    standard error file. For example:

        sample >sample.out 2>&1

    The exception data is now in the file
    'sample.out'.

  ADDITIONAL HARDWARE/SOFTWARE REQUIREMENTS:
    None

  VISUALAGE FOR C++ SAMPLES INFORMATION:
    A complete listing of samples shipped with the VisualAge for C++
    product can be found in the online GUIDE TO SAMPLES.  To access
    this notebook, simply:

    -  Open the VISUALAGE FOR C++ program group in the Program
       Manager window, then
    -  Open the GUIDE TO SAMPLES notebook in the program group.

