Legacy Document

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

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

/ Creating Buttons

<Radio Button Launch New Seq>

You can use the <Radio Button Launch New Seq> command to place a radio button on a panel and to launch a new sequence according to the settings of the radio buttons. You should usually use the <Radio Button> command instead of the <Radio Button Launch New Seq> command.

<Radio Button Launch New Seq> buttonTitle, buttonState 
                              [, seqTrue] [, seqFalse]
                              [, buttonAnchor] [, buttonFont]

buttonTitle

A string specifying the radio button's title.

buttonState

A Boolean constant indicating the default state of the radio button. Specify TRUE to set the radio button to on, specify FALSE to set the radio button to off. Only one radio button in a set can have its default state set to TRUE.

seqTrue

The name of the sequence to launch if the radio button is on (TRUE). If you specify a sequence name in this parameter, you should omit the seqFalse parameter. This parameter is optional.

seqFalse

The name of the sequence to launch if the radio button is off (FALSE). You usually do not specify this parameter, but if you do, you should omit the seqTrue parameter. This parameter is optional.

buttonAnchor

A point that indicates the anchor point of the radio button. To describe a specific point, use the Point function. This parameter is optional.

buttonFont

A constant specifying the font of the button's title. You can use either of these constants to specify the corresponding font:

APPLEGUIDE

Specifies 10-point Espy Serif.

SYSTEM

Specifies the system font of the current script system. For example, for Roman script systems, indicates 12-point Chicago.

This parameter is optional; if you omit this parameter Apple Guide displays the button title in the system font.

DESCRIPTION

The <Radio Button Launch New Seq> command places a radio button with the specified title on a panel. If you specify the seqTrue or seqFalse parameter, Apple Guide inserts the specified sequence into the current sequence, according to the setting of the radio button.

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

Radio buttons appear inline with the surrounding text and are justified within the current format unless you specify an optional anchor point.

Always provide in your panel a label identifying the group of choices that your radio buttons offer. You can place this label on the panel and then use the <Radio Button Launch New Seq> command to place your radio buttons.

SPECIAL CONSIDERATIONS

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

EXAMPLES

<Define Panel> "Index Choices"
   #label for this group of radio buttons
   What type of index do you want to create?

   #similar to <Radio Button> command, only sequences are
   # launched (user can't go back to original sequence)
   # rather than inserted
   <Radio Button Launch New Seq> "Book Index", TRUE, \xAC
                  "How do I create a book index?"
   <Radio Button Launch New Seq> "Chapter Index", FALSE, \xAC
                  "How do I create a chapter index?"
<End Panel>

SEE ALSO

For information on the <Radio Button> command, see page 10-64. For information on the <Launch New Sequence> command, see page 10-49.