Legacy Document

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

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

/ Specifying Events

<On Panel Create>

You can use the <On Panel Create> command to define an event function that Apple Guide executes before displaying a panel.

<On Panel Create> eventFunction   

eventFunction

An event function or event list.

DESCRIPTION

The <On Panel Create> command defines an event function or event list for a panel. Apple Guide executes the event function when Apple Guide creates the panel to which it is attached. Apple Guide executes the event function before displaying the panel on the screen. Event functions are usually used to send an Apple event to a target application, requesting it to perform some action.

You can use multiple <On Panel Create> commands per panel. Apple Guide executes any event functions in the order in which the <On Panel Create> command appears in your panel definition.

EXAMPLES

#define doExamplePanelAction as an event function that sends to 
# the app with signature 'WAVE' (SurfWriter) the Apple event
# defined by event class 'sfwr' and event ID 'act1'
<Define Event> "doExamplePanelAction", 'WAVE', 'sfwr', 'act1'

<Define Panel> "Example Panel"
   <On Panel Create> doExamplePanelAction()
   <On Panel Create> PlaySound(1000)
<End Panel>

SEE ALSO

For information on Guide Maker's built-in event functions, see "Built-in Event Functions" on page 10-188. For information on the <Define Event> and <Define Event List> commands, see page 10-178 and page 10-181, respectively.