Resolving and Creating Object Specifier Records

- AppleEvent Object Specifier Records
  - tclAE::setObjectCallbacks
  - tclAE::resolve
  - tclAE::callObjectAccessor
  - tclAE::getObjectAccessor
  - tclAE::installObjectAccessor
  - tclAE::removeObjectAccessor
  - tclAE::disposeToken

This page describes Tcl® calls for creating and interpreting object specifier records. For information on the associated ToolBox calls and data types, see INSIDE MACINTOSH: Interapplication Communication:Resolving and Creating Object Specifier Records.

# AppleEvent Object Specifier Records

## `tclAE::setObjectCallbacks`

Tcl wrapper for ToolBox `AESetObjectCallbacks` call.

### Synopsis

`tclAE::setObjectCallbacks compareProc countProc disposeTokenProc getMarkTokenProc markProc adjustMarksProc`

### Result

None.

### Description

This call stores Tcl procs to be used during resolution of AppleEvent object specifier records.

## `tclAE::resolve`

Tcl wrapper for ToolBox `AEResolve` call.

### Synopsis

`tclAE::resolve [flags] objectSpecifier`

### Result

Resolved token.

### Description

Resolves the object specifier record passed in the `objectSpecifier` parameter with the help of your object accessor functions.

`flags` can be:

`-m`
  application provides marking callback functions
`-w`
  application supports whose tests (supports key form `formWhose`)

## `tclAE::callObjectAccessor`

Tcl wrapper for ToolBox `AECallObjectAccessor` call.

### Synopsis

`tclAE::resolve desiredClass containerToken containerClass keyForm keyData`

### Result

Resolved token.

### Description

Invokes the appropriate object accessor proc for a specific desired type and container type.

## `tclAE::getObjectAccessor`

Tcl wrapper for ToolBox `AEGetObjectAccessor` call.

### Synopsis

`tclAE::getObjectAccessor desiredClass containerType`

### Result

Object accessor proc.

### Description

Gets an object accessor proc from the object accessor hash table.

## `tclAE::installObjectAccessor`

Tcl wrapper for ToolBox `AEInstallObjectAccessor` call.

### Synopsis

`tclAE::installObjectAccessor desiredClass containerType theAccessor`

### Result

None.

### Description

Adds or replaces an entry for an object accessor proc to the object accessor hash table.

## `tclAE::removeObjectAccessor`

Tcl wrapper for ToolBox `AERemoveObjectAccessor` call.

### Synopsis

`tclAE::removeObjectAccessor desiredClass containerType theAccessor`

### Result

None.

### Description

Removes an object accessor proc from the object accessor hash table.

## `tclAE::disposeToken`

Tcl wrapper for ToolBox `AEDisposeToken` call.

### Synopsis

`tclAE::disposeToken theToken`

### Result

None.

### Description

Deallocates the memory used by a token.

Copyright © 2001Ð2003 Jonathan E. Guyer
All rights reserved.

Last modified Monday, March 3, 2003 11:55:06 PM