Inside Macintosh: Interapplication Communication /

Chapter 2 - Edition Manager

Using the Edition Manager

This section describes how your application can

• receive Apple events from the Edition Manager
• set up a section record and alias record for open documents containing sections
• save a document that contains sections
• open a document that contains sections
• read and write sections
• create a publisher within a document, create its edition container, and write data to it
• create a subscriber within a document and read its data from an edition

To begin, you must determine whether the Edition Manager is available on the system by using the Gestalt function with the gestaltEditionMgrAttr ('edtn') selector. If the response parameter returns 1 in the bit defined by the gestaltEditionMgrPresent constant (bit 0), the Edition Manager is present.

If the Edition Manager is present, load it into memory using the InitEditionPack function. This function determines whether the machine has enough space in the system heap for the Edition Manager to operate.

err := InitEditionPack;

If the InitEditionPack function returns noErr, you have enough space to load the package. If you do not have enough space, the application can either terminate itself or continue with the Edition Manager functionality disabled.

---

Subtopics

Receiving Apple Events From the Edition Manager

Creating the Section Record and Alias Record

Saving a Document Containing Sections

Opening and Closing a Document Containing Sections

Reading and Writing a Section

Creating a Publisher

Creating a Subscriber

Using Publisher and Subscriber Options

Renaming a Document Containing Sections

Displaying Publisher and Subscriber Borders

Modifying a Subscriber

Relocating an Edition

Customizing Dialog Boxes