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 Destroy>

You can use the <On Panel Destroy> command to define an event function that Apple Guide executes when destroying a panel. It executes the event after removing the panel from the screen.

<On Panel Destroy> eventFunction

eventFunction

An event function or event list.

DESCRIPTION

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

You can use multiple <On Panel Destroy> commands per panel. Apple Guide executes any event functions in the order in which the <On Panel Destroy> 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 Destroy> doExamplePanelAction()
   <On Panel Destroy> 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.