Inside Macintosh: Cyberdog Programmer's Kit / Part 2 - Programming in Cyberdog

Chapter 5 - Embedding a Cyberdog Display Part in a Navigator

This chapter outlines the steps required to embed a Cyberdog display part in a Cyberdog navigator. A Cyberdog navigator is an OpenDoc container part that has an associated Cyberdog navigator extension. When embedded in a Cyberdog navigator, the display part appears as the content area in the navigator's frame. From the navigator, the user can issue navigation commands, such as "next" and "previous."

You develop a Cyberdog display part that you want to embed in a navigator much as you develop any Cyberdog display part. You should be familiar with the steps required to build a Cyberdog display part, which are described in the previous chapter, "Creating a Cyberdog Display Part" (page 115). When developing an embedded display part, you typically need to provide support for several operations:

• opening an embedded display part in a navigator when the part is opened by a Cyberdog item
• opening a Cyberdog item from a display part embedded in a navigator
• using a progress broadcaster to update the status bar area of a navigator
• enabling a navigator's Save a Copy, Page Setup, and Print commands from an embedded display part

This chapter shows how to implement these operations. This chapter assumes that you are working with an example Cyberdog display part class, such as the one described in "Implementing Your Cyberdog Display Part Class" (page 120). The examples in the following sections use an embedded text-viewer display part class called CybTxtNavViewer.

---

Chapter Contents

Modifying Your Cyberdog Display Part Class

Opening a Display Part Embedded in a Navigator

Opening a New Cyberdog Item in the Same Navigator

Using a Progress Broadcaster

Setting Up the Progress Broadcaster

Implementing the Abort Callback Function

Attaching the Broadcaster Object

Detaching the Broadcast Object

Sending Status Messages to the Navigator

Enabling Menu Items From an Embedded Display Part