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.