=====================================================================
cnrhelpw.zip    this package demonstrates how to define
                context-sensitive help for container columns
                and/or the container itself using VisualAge
                for C++ for Windows.  (NOTE: to see how to provide
                the same help using VisualAge for C++ for OS/2,
                get the cnrhelpo.zip package).
=====================================================================


This sample package (cnrhelpw.zip) file contains the following files:
=====================================================================
   CNRHELP.VBB  file that contains the following parts:
                CnrHelpSample and ICnrHandler
   CNRHLPSM.EXE application that demonstrates context-sensitive help
                for direct-edit container columns and for a container
                itself
   CUSTOMER.IPF source help file containing context-sensitive help
   CUSTOMER.HLP help file (built using IPFC)
   README.TXT   this file


Class Descriptions:
==========================================================================
   CnrHelpSample           Part that demonstrates how to define context-
                           sensitive help for a container column that
                           supports direct-edit and for the container itself.
   ICnrHandler             Handler that's used by CnrHelpSample to
                           provide context-sensitive help for the container
                           itself.  This handler can be used by any
                           IVBContainerControl* part.  The class for this
                           handler is provided in the Open Class Library
                           of VisualAge for C++ for Windows.  This package
                           defines a part for this class.
   IVBCnrEditHandler       Handler that's used to provide direct-edit
                           support for the columns of a details view
                           container.  This part is contained in VBBASE.VBB.


Instructions for viewing the CnrHelpSample part in this package:
==========================================================================
   1. Load the CNRHELP.VBB file that is shipped in this package
      Also, load \ibmcppw\ivb\VBSAMPLE.VBB.

   2. Open the CnrHelpSample part.  This part shows how to
      define help for container columns and for the container
      itself (it also provides context-sensitive help for the
      entry fields that are labeled 'Work phone' and 'Home
      phone') using VisualAge for C++ for Windows. More detailed
      instructions for providing help follow.


Instructions for defining container help:
==========================================================================
   -- To define help for a container column and/or a container,
      you must select the IHelpWindow* part from the Other
      category on the Parts Palette and drop it onto the
      freeform surface.  Open the settings for the IHelpWindow*
      part and specify the appropriate Help libraries (NOTE:
      this example, specified CUSTOMER.HLP as the help library.
      On the Styles page, the ipfCompatible style was also set On).

   -- To define help for a container column that the user can
      direct edit (there's another sample that explains how
      to provide direct edit support for the columns of a
      details view container), connect the ready event of the
      freeform surface to the helpId attribute of the container
      column.  Open the connection settings, select the
      'Set parameters' push button, and then specify the
      appropriate resource id for the helpId field/attribute.
      The CnrHelpSample part defines help for the Work phone
      and Home phone container columns.

   -- To define help for the container itself, attach ICnrHandler()
      to the container (NOTE: this handler can be attached to any
      IVBContainerControl part).  To attach ICnrHandler() to a
      container, open the settings for the IVBContainerControl* part,
      tab to the Handler page, and add ICnrHandler() to the handler
      list. (NOTE: the CnrHelpSample part also includes
      IVBCnrEditHandler() in its handler list.  This handler provides
      direct-edit support for the details view container columns).
      Next, tab to the Control page of the container's settings and
      specify the appropriate Help panel id.


Instructions for executing this sample application:
==========================================================================
   -- Run CNRHLPSM.EXE.
   -- The initial focus should be on the container.  Select
      F1 to get help on the container itself.  This help
      panel explains how to update and get help on the
      'Work phone' and 'Home phone' container columns.
   -- Direct edit the 'Work phone' or 'Home phone' columns
      and then select F1.
   -- You can also select F1 when the 'Work phone' and 'Home
      phone' fields have focus.  The same help panel is shown
      for the 'Work phone' entry field and the 'Work phone'
      container column.  Likewise, the same help panel is shown
      for the 'Home phone' entry field and the 'Home phone'
      container column.


