Important: The information in this document is obsolete and should not be used for new development.
AESetTheCurrentEvent
You can use theAESetTheCurrentEvent
function to specify the Apple event to be handled.
FUNCTION AESetTheCurrentEvent (theAppleEvent: AppleEvent): OSErr;
theAppleEvent
- The Apple event to be handled.
DESCRIPTION
There is usually no reason for your application to use theAESetTheCurrentEvent
function. Instead of calling this function, your application should let the Apple Event Manager set the current Apple event through the dispatch tables.If you need to avoid the dispatch tables, you must use the
AESetTheCurrentEvent
function only in the following way:
- Your application suspends handling of an Apple event by calling the
AESuspendTheCurrentEvent
function.- Your application calls the
AESetTheCurrentEvent
function. This informs the Apple Event Manager that your application is handling the suspended Apple event. In this way, any routines that call theAEGetTheCurrentEvent
function can ascertain which event is currently being handled.- When your application finishes handling the Apple event, it calls the
AEResumeTheCurrentEvent
function with the valuekAENoDispatch
to tell the Apple Event Manager that the event has been processed and need not be dispatched.
RESULT CODE
noErr 0 No error