Jeanne's World
   Apple Guide Place
       Apple Guide FAQs

Apple Guide:

What is hot text?
How do I decide whether to use hot text?
How do I show the user which text is hot?
How do I make hot text that pops up a new window?
How do I make hot text perform an action?
How do I make pictures and non-text objects hot?
Why can't the compiler find my hot text?
Why doesn't my hot text formatting appear in the guide?
Why doesn't hot text work when the user clicks it?

How do I make hot text pop up a new window?

The most common use of hot text in guides is to open a second Apple Guide window, usually a definition. The original window remains on the screen, so the user can simply close the definition window to go back to the task.

You must define a separate sequence for the second window (or use a sequence already defined elsewhere in your guide). This sequence can contain anything you want, but usually it's a good idea to make it a single panel. This diminishes the chance that the user will get sidetracked away from the original task.

To make text in a panel hot, you use the <hot text> command immediately before the paragraph that contains the text. If the hot text is "lizard", and clicking it opens the sequence "lizard definition", your panel definition might look like this:

<define panel> "My Panel"  <format> "Full"  <hot text> "lizard", FIRST, LaunchNewSequenceNewWindow("Lizard Definition")
The physiology of the lizard is rich with meaning for the researcher. Lizard physiology holds deep lessons for our modern world.
 <panel prompt> "Standard" <end panel>

When the user clicks the word "lizard", a second window containing the sequence "Lizard Definition" opens on top of the original window.

 Next: How do I make hot text perform an action?

Jeanne A. E. DeVoto
Copyright © 1996 Jeanne A. E. DeVoto