Legacy Document

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

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

/ Creating Hot Items

<Hot Object>

You can use the <Hot Object> command to create a hot button on a panel.

<Hot Object> eventFunction 

eventFunction

A name of an event function or event list. You must also include any parameters expected by the function in parentheses following the event function name. You define event functions using the <Define Event> or <Define Event List> command. Guide Maker also provides built-in functions that you can specify in this parameter.

DESCRIPTION

The <Hot Object> command creates a hot button using the rectangle of the next object (text or graphic) specified in the panel definition. The area encompassing this rectangle acts as a "hot" button; that is, when the user clicks in this rectangle, Apple Guide calls the function defined by the eventFunction parameter. Usually such a function is used to send a specific Apple event.

EXAMPLES

<Define Panel> "spell-checking a document"
   Select a dictionary to open:

   <Hot Object> openDictionary("Sharon's Super Dictionary")
   Sharon's Super Dictionary

   <Hot Object> openDictionary("Daphne's Fantastic Dictionary")
   Daphne's Fantastic Dictionary

<End Panel>

SEE ALSO

For information on creating a hot rectangle or hot text, see the descriptions of the <Hot Rectangle> and <Hot Text> commands. For information on event functions, see "Specifying Events" beginning on page 10-177.