Legacy Document

Inside Macintosh: Apple Guide Complete / Part 4 - Scripting Guide Files

Chapter 10 - Guide Script Command Reference / Guide Script Command Descriptions

/ Creating Sequences

<Jump Sequence>

You can use the <Jump Sequence> command to jump to another sequence from the current sequence.

<Jump Sequence> sequenceName

sequenceName

A text string specifying the name of the sequence to jump to.

DESCRIPTION

Unlike the <Insert Sequence> command, the <Jump Sequence> command jumps directly to the named sequence. The jumped-to sequence is treated as a separate entity in the guide file and is jumped to and returned from at the appropriate times in the calling sequence. Like the <Insert Sequence> command, the <Jump Sequence> command lets you reuse sequences that are common to one or more help topics. You also might use <Jump Sequence> commands within <If> and <End If> commands.

SPECIAL CONSIDERATIONS

Any sequence that uses <Jump Sequence> commands must have at least one panel that is guaranteed to be shown before the first <Jump Sequence> command. You should also show at least one panel between <Jump Sequence> commands.

Any panels inserted by a <Jump Sequence> command do not apply toward a sequence's 32-panel limit.

You can use the <Jump Sequence> command if Guide Maker informs you that the current sequence exceeds limitations.

EXAMPLES

#sequence that is reused often
<Define Sequence> "How do I use the tool bar?"
   <Panel> "tool bar:intro"
   <Panel> "tool bar:tools"
<End Sequence>
#sequence that jumps to another sequence
<Define Sequence> "How do I create footnotes?"
   <Panel> "footnotes:intro"
   <Jump Sequence> "How do I use the tool bar?"
   <Panel> "footnotes:editing"
<End Sequence>
#sequence that jumps to a sequence depending on a condition
<Define Sequence> "How do I spell-check a document?"
   <Panel> "spell-checking:intro"
   <If> NOT isDictionaryOpen()
      <Jump Sequence> "How do I open the dictionary?"
   <End If>
   <Panel> "spell-checking:options"
<End Sequence>

SEE ALSO

For information on the <Insert Sequence> command, see page 10-46. The <Launch New Sequence> command is described next.