Legacy Document

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

Chapter 7 - Classes and Methods / CyberSession

AcquireContainingNavigatorPart

Acquires a frame's containing navigator.

ODPart AcquireContainingNavigatorPart (in ODFrame frame);

frame

The frame where the search for a containing navigator begins.

return value

A reference to the navigator that contains the frame, if one exists; otherwise, kODNULL.

DISCUSSION

You call this method to retrieve a frame's containing navigator part, if one exists. This method traverses the frame hierarchy until it finds the navigator.

This method increments the reference count of the ODPart object that it returns; the caller is responsible for calling the ODPart object's Release method.

Do not subclass this class.

SEE ALSO

The IsContainedInRootNavigatorPart method (page 366).