Executing Macros from a Topic Footnote

If a Help macro is included in a topic footnote, Windows Help executes that macro when the user displays that topic. Users can execute a macro footnote in a topic by:

nChoosing a hot spot that jumps to that topic.

nChoosing the Back button or a browse button.

nSelecting a topic from the history list or keyword search list.

nSelecting a command or other feature in the application that is programmed to display the topic.

Macro footnotes are executed only when the user first displays the topic, not when the user completes any other action within the same topic.

You use an exclamation point (!) as the footnote character to execute topic-entry macros.

To insert a topic-entry macro

1.1.Position the insertion point at the beginning of the topic (to the right of the other footnotes).

2.2.From the Insert menu, choose Footnote.

The Footnote dialog box appears.

3.3.Type an exclamation point as the custom footnote mark, and then choose OK.

A superscript exclamation point ( ! ) appears in the text window, and the insertion point moves to the footnote window.

4.4.Type the macro to the right of the exclamation point in the footnote window.

Use only a single space between the exclamation point and the first word of the macro. For example, you might type the following:

! SaveMark("Creating Groups")

Figure 14.1 shows this footnote window.

Note that you can include spaces in macros.

For more information about how to insert macro footnotes in your Help topics, see Chapter 6, “Creating Topics.”