Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

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

Chapter 7 - Classes and Methods / CyberItemPromptExtension

PromptForCyberItem
Displays the Connect To dialog box and returns the Cyberdog item specified by the user.
CyberItem PromptForCyberItem (in Str255 windowTitle);
windowTitle
The title to be used for the Connect To dialog box.
return value
A CyberItem object if the user specified one; otherwise, kODNULL.

DISCUSSION
This method displays the Connect To dialog box with the specified title. The dialog box allows the user to select from any services installed in the system and to specify a Cyberdog item in the corresponding Connect To panel. This method calls the CyberConnectExtension::CreateCyberItem method to retrieve the Cyberdog item specified by the user in the Connect To panel and then returns that item.
You should not call this method directly; to prompt the user for a Cyberdog item, you should call CyberSession::PromptForCyberItem, which calls this method.
If you subclass CyberItemPromptExtension, you must override this method. Your override must not call its inherited method; that is, your override method must implement this method's functionality completely.

SEE ALSO
The CyberConnectExtension::CreateCyberItem method (page 206).
The CyberSession::PromptForCyberItem method (page 371).