Legacy Document

Inside Macintosh: Interapplication Communication /

Chapter 10 - Scripting Components / Scripting Components Reference

Application-Defined Routines /

MyAECreateProc

Your application can provide an alternative create function to gain control over the creation and addressing of Apple events. This can be useful, for example, if your application needs to add its own transaction code to the event. An alternative create function takes the same parameters as the AECreateAppleEvent function plus a reference constant.

FUNCTION MyAECreateProc (theAEEventClass: AEEventClass; 
                         theAEEventID: AEEventID; 
                         target: AEAddressDesc; 
                         returnID: Integer; 
                         transactionID: LongInt; 
                         VAR result: AppleEvent;
                         refCon: LongInt): OSErr;

DESCRIPTION

Every scripting component calls a create function whenever it creates an Apple event during script execution and provides routines that allow you to set or get the pointer to the create function.

If you don't set an alternative create function for a scripting component, it uses the standard Apple Event Manager function AECreateAppleEvent, which it calls with its own default parameters.

SEE ALSO

For descriptions of the scripting component routines you can use to set or get the pointer to a scripting component's create function, see "Manipulating the Create and Send Functions," which begins on page 10-55.

For information about create functions, see "Alternative Create Functions" on page 10-24.

For a description of the parameters for the AECreateAppleEvent function, see "Creating Apple Events," which begins on page 5-25.