This page describes Tcl® calls for handling received AppleEvents and AppleEvent descriptor type coercion requests. For information on the associated ToolBox calls and data types, see INSIDE MACINTOSH: Interapplication Communication.
tclAE::installCoercionHandlerTcl wrapper for ToolBox AEInstallCoercionHandler call.
tclAE::installCoercionHandler
fromType
toType
coercionHandlerProc
None.
This call allows Tcl procs to act as AEDesc coercion handlers.
tclAE::getCoercionHandler
Tcl wrapper for ToolBox AEGetCoercionHandler call.
tclAE::getCoercionHandler
fromType
toType
Name of Tcl coercion proc.
The Tcl® coercion hash table is searched for the proc mapped
by fromType
and toType.
If the AEM has a registered coercion handler that is not a Tcl
proc, the result will be empty, but no error is thrown.
Tell me how you want this to work!!!
Throws OSErr -1717 (errAEHandlerNotFound) if
there is no entry in the coercion hash table.
tclAE::removeCoercionHandler
Tcl wrapper for ToolBox AERemoveCoercionHandler call.
tclAE::getCoercionHandler
fromType
toType
coercionHandlerProc
None.
The Tcl® coercion hash table is searched for the proc mapped
by fromType
and toType and
matched with coercionHandlerProc.
Although the fromType and toType parameters would be
sufficient to identify the handler to be removed, providing the
coercionHandlerProc
parameter is a safeguard to ensure that you remove the correct handler.
Throws OSErr -1717 (errAEHandlerNotFound) if
there is no matching entry in the Tcl®Õs coercion hash table.
tclAE::installEventHandler
Tcl wrapper for ToolBox AEInstallEventHandler call.
tclAE::installEventHandler
aeclass
aeeventID
eventHandlerProc
None.
This call allows a Tcl proc to act as an AppleEvent handler.
tclAE::getEventHandler
Tcl wrapper for ToolBox AEGetEventHandler call.
tclAE::getEventHandler
aeclass
aeeventID
Name of Tcl AppleEvent handler proc.
The Tcl® event handler hash table is searched for the proc
mapped by aeclass and aeeventID.
If the AEM has an event handler that is not a Tcl proc, the
result will be empty, but no error is thrown.
Tell me how you want this to work!!!
Throws OSErr -1717 (errAEHandlerNotFound) if
there is no entry in the event handler hash table.
tclAE::removeEventHandlerTcl wrapper for ToolBox AEGetEventHandler call.
tclAE::getCoercionHandler
aeclass
aeeventID
eventHandlerProc
None.
The Tcl® event handler hash table is searched for the proc
mapped by this aeclass and aeeventID and matched
with eventHandlerProc.
Although the aeclass and aeeventID parameters
would be sufficient to identify the handler to be removed, providing the
eventHandlerProc
parameter is a safeguard to ensure that you remove the correct handler.
Throws OSErr -1717 (errAEHandlerNotFound) if
there is no matching entry in the coercion hash table.
Copyright © 1999Ð2000 Jonathan E. Guyer
All rights reserved.