Legacy Document

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

Chapter 7 - Classes and Methods / CyberPartExtension

GetSelectedURL

Retrieves the selected URL.

char* GetSelectedURL (in ODFrame frame);

frame

The frame to check for selected text.

return value

A pointer to a string that contains the selected URL.

DISCUSSION

This method should return a string copy of the URL selected in the specified frame. The superclass implementation of this method returns kODNULL. If a Cyberdog display part allows the user to select and open a URL, its CyberPartExtension subclass must override this method.

You should call this method after calling the IsURLSelected method to test whether the selected text is a URL.

If you subclass CyberPartExtension and 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 IsURLSelected method (page 290).