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

Chapter 7 - Classes and Methods

CyberNavigatorExtension

Superclasses

CyberOpenerPartExtension --> CyberProgressPartExtension --> CyberExtension --> ODExtension --> ODRefCntObject --> ODObject

Subclasses

none

The CyberNavigatorExtension class defines extra behaviors for a part that is to be used as a navigator.

Description

The CyberNavigatorExtension class is an abstract class that you can subclass to create an extension that allows a part to be used as a navigator. Cyberdog provides a fully implemented navigator; to use this navigator, you do not need to subclass this class.

A navigator serves as a container part for display parts that display content referenced by Cyberdog items. The Cyberdog-provided Gopher, FTP, and HTML display parts are displayed embedded in the navigator. If you want to display your Cyberdog display part embedded in a navigator, you should override the display part's OpenCyberItem method to call the navigator's GoToCyberItem method.

A navigator keeps track of its visitation history, the sequence of Cyberdog items and associated display parts that it displays. A navigator adds a Cyberdog item to its visitation history when the location the item represents is visited. The navigator provides a user interface that allows the user to view the history of the items visited and to open an item in the history.

CyberNavigatorExtension is derived from CyberProgressPartExtension; in other words, the navigator is a progress part. The navigator can display progress information to the user when Cyberdog items are resolved and downloaded.

Methods

This section presents summary descriptions of the CyberNavigatorExtension methods grouped according to purpose, followed by detailed descriptions.

Initialization and Cleanup

ICyberNavigatorExtension

Initializes this CyberNavigatorExtension object.

Detecting Changes

CurrentCyberItemChanged

Notifies this navigator that the current Cyberdog item has changed.

Navigation

GetHistory

Retrieves the visitation history for this navigator.

GoToCyberItem

Displays the content referenced by a Cyberdog item in this navigator.

NavigateToCyberItem

Displays the content referenced by a Cyberdog item that has been shown in this navigator.

NextCyberItem

Displays the content referenced by the next Cyberdog item in this navigator's visitation history.

PreviousCyberItem

Displays the content referenced by the previous Cyberdog item in this navigator's visitation history.

---

Methods

CurrentCyberItemChanged

GetHistory

GoToCyberItem

ICyberNavigatorExtension

NavigateToCyberItem

NextCyberItem

PreviousCyberItem