Using the Standard Buttons

Help provides six buttons for use with Help files. The standard buttons provide access to six commonly used Help macros. Four of the buttons are required, and two are optional buttons in your Help file. The standard button bar is shown in Figure 13.3.:

You can access the standard button functionality if you use the specified button IDs. The standard buttons have the following IDs, macros, and functions.

Button ID Macro Description

Contents btn_contents Contents Displays the Contents topic, which is the first topic in the Help file.
Index btn_search Search Displays the Search dialog box.
Go Back btn_back Back Jumps to the last topic the user displayed in the main window.
History btn_history History Displays the History window.
<< (Browse Previous) btn_previous Prev Jumps to the previous topic in the browse sequence.
>> (Browse Next) btn_next Next Jumps to the next topic in the browse sequence.

How Help Disables Standard Buttons

In certain situations, Help automatically disables buttons with the following button IDs.

Button ID Disabled when

btn_back Using the Go Back button or the history list, the user returns to the first topic in the history list.
btn_previous Help is displaying the first topic in the browse sequence.
btn_next Help is displaying the last topic in the browse sequence.

This behavior provides useful feedback to the users. If you define custom Previous and Next buttons without using the button IDs listed in the preceding table, Help cannot disable the buttons in the situations described above. To define these buttons using custom paging devices, be sure to use the specified button IDs in your CreateButton or InsertButton macros.