Legacy Document

Inside Macintosh: Interapplication Communication /

Chapter 4 - Responding to Apple Events / Reference to Responding to Apple Events

Routines for Responding to Apple Events

Creating and Managing the Special Handler Dispatch Tables

The Apple Event Manager provides three functions that allow you to create and manage the special handler dispatch tables. The AEInstallSpecialHandler function installs an entry for a special handler in either the application or system special handler dispatch table. The AEGetSpecialHandler function returns the handler for a specified special handler. The AERemoveSpecialHandler function removes a special handler from either the application or system special handler dispatch table.

You can also use the AEInstallSpecialHandler, AEGetSpecialHandler, and AERemoveSpecialHandler functions to install, get, and remove object callback functions--including system object callback functions, which cannot be installed with the AESetObjectCallbacks function. When calling any of these three functions, use one of the following constants as the value of the functionClass parameter to specify the object callback function:

Object callback function	Constant
Object-counting function	keyAECountProc
Object-comparison function	keyAECompareProc
Token disposal function	keyDiposeTokenProc
Error callback function	keyAEGetErrDescProc
Mark token function	keyAEMarkTokenProc
Object-marking function	keyAEMarkProc
Mark-adjusting function	keyAEAdjustMarksProc

You can also use the AERemoveSpecialHandler function to disable all the Apple Event Manager routines that support object specifier records. To do this, specify the constant keySelectProc in the functionClass parameter as described on page 4-102.

---

Subtopics

AEInstallSpecialHandler

AEGetSpecialHandler

AERemoveSpecialHandler