Carbon


Callback Constants for the AEResolve Function

Header: AEObjects.h

Specify supported callback features to the AEResolve function.

enum {
    kAEIDoMinimum = 0,
    kAEIDoWhose = 1,
    kAEIDoMarking = 4,
    kAEPassSubDescs = 8,
    kAEResolveNestedLists = 16,
    kAEHandleSimpleRanges = 32,
    kAEUseRelativeIterators = 64
};

Constant descriptions

kAEIDoMinimum

The application does not handle whose tests or provide marking callbacks.

kAEIDoWhose

The application supports whose tests (supports key form formWhose).

kAEIDoMarking

The application provides marking callback functions. Marking callback functions are described in “Object Callback Functions”.

kAEPassSubDescs
kAEResolveNestedLists
kAEHandleSimpleRanges
kAEUseRelativeIterators

You use these constants to supply a value for the callbackFlags parameter to the AEResolve function. This value specifies whether your application supports whose descriptor records or provides marking callback functions. To obtain a value for this parameter, you can add together constants to set the appropriate bits, as shown in the following example (for an application that supports both whose tests and marking):

AEDesc objectSpecifier; // Previously obtained object specifier. AEDesc resultToken;

OSErr myErr;

myErr = AEResolve (&objectSpecifier,

kAEIDoWhose + kAEIDoMarking, &resultToken);

AppleScript generates whose clauses from script statements such as the following:

tell application "Finder"

every file in control panels folder whose file type is "APPL"

end tell


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)