Legacy Document

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

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

/ Creating Sequences

<Launch New Sequence>

You can use the <Launch New Sequence> command if you need to break complex sequences into smaller subsequences.

<Launch New Sequence> sequenceName

sequenceName

A text string specifying the name of the new sequence.

DESCRIPTION

The <Launch New Sequence> command displays the named sequence in the same window as the current sequence, and the user navigates to it using the right arrow button. However, the user cannot navigate back to the original sequence using the left arrow button after beginning the new sequence.

If you use the <Launch New Sequence> command, you usually specify it as the last command in the current sequence definition.

You can also use the <Radio Button Launch New Seq> command to launch new sequences in response to the user choosing a radio button. Alternatively, you can launch a new sequence as a result of the user choosing a button by linking the button to the built-in function LaunchNewSequence.

SPECIAL CONSIDERATIONS

Use the <Launch New Sequence> command only if Guide Maker informs you that the current sequence exceeds limitations.

EXAMPLES

#sequence to launch to
<Define Sequence> "How do I make a multibook index?"
   <Panel> "multibook setup"
   <Panel> "multibook combine"
   <Panel> "multibook generate"
<End Sequence>
#sequence that launches another sequence
<Define Sequence> "How do I create an index?"
   <Panel> "index techniques"
   <Panel> "editing index entries"
   <Launch New Sequence> "How do I make a multibook index?"
<End Sequence>

SEE ALSO

For information on the <Insert Sequence> and <Jump Sequence> commands, see page 10-46 and page 10-47, respectively. For information on the <Radio Button Launch New Seq> command, see page 10-66. For information on the built-in event functions LaunchNewSequence and LaunchNewSequenceNewWindow, see page 10-188.