Legacy Document

Inside Macintosh: Interapplication Communication /

Chapter 6 - Resolving and Creating Object Specifier Records / Reference to Resolving and Creating Object Specifier Records

Application-Defined Routines / Object Callback Functions

MyMark

If your application supports marking, you must provide one object-marking function. An object-marking function marks a specific Apple event object.

FUNCTION MyMark (theToken: AEDesc; markToken: AEDesc; 
                 markCount: LongInt): OSErr;

theToken

The token for the Apple event object to be marked.

markToken

The mark token used to mark the Apple event object.

markCount

The number of times MyMark has been called for the current mark token (that is, the number of Apple event objects that have so far passed the test, including the element to be marked).

DESCRIPTION

To mark an Apple event object using the current mark token, the Apple Event Manager calls the object-marking function provided by your application. In addition to marking the specified object, your MyMark function should record the mark count for each object that it marks. The mark count recorded for each marked object allows your application to determine which of a set of marked tokens pass a test, as described in the next section for the MyAdjustMarks function.

RESULT CODES

noErr	0	No error occurred
errAEEventNotHandled	-1708	The MyMark function is unable to mark the specified Apple event object; if the Apple Event Manager gets this result, it attempts to mark the object by calling the equivalent system object-marking function

SEE ALSO

For more information, see "Writing Marking Callback Functions," which begins on page 6-62.