Legacy Document

Inside Macintosh: Cyberdog Programmer's Kit / Part 3 - Cyberdog Reference

Chapter 7 - Classes and Methods / CyberItem

Resolve

Attempts to resolve this Cyberdog item.

void Resolve (in CyberResolveCompletionUPP completionProc, 
in void* userData, 
in ODPart progressPart);

completionProc

A pointer to a programmer-defined function that should be called when the resolution process is complete.

userData

A pointer to data that is passed to the callback function.

progressPart

A part used to display progress during the resolution process.

DISCUSSION

This method should initiate the resolution process for this Cyberdog item. Resolving a Cyberdog item may be a lengthy operation; therefore, this method is asynchronous. If the Cyberdog item is not resolved, Resolve begins whatever asynchronous computation is necessary to resolve it and returns to the caller immediately. The method calls the callback function when the resolution is complete. The superclass implementation of the Resolve method calls the callback function immediately.

If you are implementing a Cyberdog item subclass whose objects cannot always identify the kind of data they refer to, you must override this method.

The following type is used for the resolution notification function. The function takes three parameters: an error code, a pointer to a Cyberdog item, and a pointer to some data. The function returns no value.

typedef void (* CyberResolveCompletionProcPtr) (OSErr err,
CyberItem* item,
Ptr userDataPtr);

The MyCyberItemResolved programmer-defined function (page 190) illustrates the form of a resolution notification function.

SEE ALSO

The IsResolved method (page 240).
The Open method (page 241).