**********************************************************************
* 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       *
*                                                                    *
**********************************************************************

Hello World Sample 4

  DESCRIPTION:
    In version 4, you initially only see a slight 
    change.  The menu items for setting the 
    alignment contain function key designations 
    and there is a new menu item, Edit.  
    Selecting the Edit menu item displays a 
    new dialog window with an entryfield and 
    push buttons that provide the ability to 
    change the static text contents. 

    The function key capability is provided by 
    adding accelerator key definitions in the 
    resource file.  The edit dialog demonstrates 
    how to use an IFrameWindow as a dialog 
    window and how to use the ICanvas 
    classes and IControls to create the dialog.  
    A new command handler is used to 
    process the push buttons.  The sample 
    also shows how to display a dialog modally. 

  CONCEPT/FEATURE: 
    Sample program with frame window, menu bar from
    resource, information area, accelerator resources,
    and dialog window.

  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:
         HELLO4

  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.

