Legacy Document

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

Chapter 7 - Classes and Methods / CyberPartExtension

OpenCyberItem

Opens a Cyberdog item in this display part.

void OpenCyberItem (in CyberItem item, 
in ODPart openerPart, 
in ParameterSet openParams);

item

The Cyberdog item to be opened.

openerPart

The opener part to use in the opening process, if any; otherwise, kODNULL.

openParams

The ParameterSet object to use in the opening process, if any; otherwise, kODNULL.

DISCUSSION

This method notifies this Cyberdog display part that it is being opened to display the content referenced by the specified Cyberdog item. The superclass implementation first calls SetCyberItem to store a reference to the Cyberdog item. Then, if an opener part is passed in as a parameter, the method calls the opener part's OpenPart method to open the Cyberdog item. If no opener part is passed in, OpenCyberItem calls the display part's Open method.

If you are creating a Cyberdog display part, you would override this method in your CyberPartExtension subclass to insert additional code into the opening process. For example, your override might take these actions:

• Notify the extension's associated part of the Cyberdog item to be opened.
• Create a progress broadcaster and attach it to a navigator or opener part to show the status of the opening process.
• Embed the display part in a navigator part.
• Retrieve a stream for downloading the data referenced by the Cyberdog item and initiate the download.

SEE ALSO

The SetCyberItem method (page 291).
The CyberOpenerPartExtension::OpenPart method (page 275).