Edition Manager Events
Edition Manager Events
If your application provides publish and subscribe capabilities, it should
handle the Apple events sent by the Edition Manager in addition to the
required Apple Events. Your application should also handle the
Create Publisher event.
The Edition Manager sends your application Apple events to communicate
information about the publishers and subscribers in your application's
documents. Specifically, the Edition Manager uses Apple events to notify
your application
when the information in an edition is updated
when your application needs to write the data from a publisher to an
edition
when your application should locate a particular publisher and scroll
the document to that location
The Apple events sent by the Edition Manager to your application are the
Section Read event, Section Write event, and Section Scroll event.
------------------------------------------------------
Section Read event read information into the specified section
Event class SectionEventMsgClass
Event ID SectionReadMsgID
Keyword keyDirectObject
Descriptor type typeSectionH
Data A handle to the section record of the subscriber
whose edition contains updated information
Requested action Update the subscriber with the new information
from the edition.
------------------------------------------------------
Section Write event write the specified section to an edition
Event clas SectionEventMsgClass
Event ID SectionWriteMsgID
Keyword keyDirectObject
Descriptor type typeSectionH
Data A handle to the section record of the publisher
Requested action Write the publisher's data to its edition.
------------------------------------------------------
Section Scroll event scroll the document to the specified section
Event class SectionEventMsgClass
Event ID SectionScrollMsgID
Keyword keyDirectObject
Descriptor type typeSectionH
Data A handle to the section record of the publisher to
scroll to
Requested action Scroll the document to the publisher identified by
the specified section record.
------------------------------------------------------
See the Edition Manager for details on how your application should respond
to these events. See Installing Apple Event Handlers for a code example
demonstrating how to install handlers for Edition Manager Events.