Table of Contents

Previous

Next


Creating What’s This (Field-Level) Help in Word

If you generate Microsoft HTML Help output, you can implement What’s This help for product dialog boxes and windows. What’s This Help is also known as field-level help. Only Microsoft HTML Help supports field-level help. In addition, not all products are designed to support field-level help for product dialog boxes and windows. Before you begin implementing field-level help, consult your product team to determine if field-level help part of the product design. If field-level help is part of the product design, you will also need to obtain the appropriate ID from your product team for each field-level help topic you need.

Users can view the field-level help you create using one of following methods:

When users click on the question mark icon, their cursor changes to a question mark. Users can then move the question mark cursor over the fields on the dialog box or window, and Windows displays the field-level help you created in a popup window when they hover over a specific field.

After users select this option, Windows displays the field-level help you specify in in a popup window.

Users close the popup window that provides the field-level help by pressing the Esc key on the keyboard. When users press the Esc key, their cursor returns to the regular cursor shape for the user.

To create What’s This help, your Stationery and template must have the following items configured:

WhatIsThisHelpIDThe following procedure provides an example of how to create What’s This help in Microsoft Word source documents using Microsoft Word 2003. Steps for creating What’s This help in Microsoft Word may be different in other versions of Microsoft Word.

To create What’s This help in a Microsoft Word source documents

  1. Identify a topic that contains field-level help.

  2. Apply the What Is This paragraph style to the text that contains the field-level help.

  3. Insert your cursor into the field-level help text.

  4. On the WebWorks menu, click Markers.

  5. In the Marker field, select WhatIsThisID from the list of markers.

  6. In the Value field, type the appropriate ID for the field-level description. Obtain appropriate IDs for each field-level description from your product team.

  7. Click OK.

  8. Save your Microsoft Word source document.

  9. Generate output for your project. For more information, see “Generating Output” on page 300.

  10. In Output Explorer, verify ePublisher created the What’s This help you specified by completing the following steps:

  11. On the View menu, click Output Directory.

  12. Open the ProjectName folder, where ProjectName is the name of your project.

  13. Open the whatisthis.txt file and verify that the field-level help you created is associated with the correct ID you received from your product development team.

  14. Open the whatisthis.h file and verify that each new string you added is listed in the file.

ePublisher/2009.1/Help/03.Preparing_and_Publishing_Content/02.062.Preparing_Word_Files (last edited 2009-05-01 02:13:40 by TonyMcDow)