151
13
Registering for Event Notifications
This chapter explains how to register for notification of a specific event. The Acrobat core API provides a
notification mechanism so that plug-ins can synchronize their actions with Acrobat or Adobe Reader.
Notifications enable plug-ins to indicate that they are interested in a specified event (such as the
initialization of Adobe Reader or Acrobat) and to provide a callback function that is invoked by Adobe
Reader or Acrobat each time an event occurs.
The order in which notifications occur may vary depending on the platform. For example, after opening a
PDF document on the Windows platform, notifications occur in this order:
1.
AVPageViewDidChange
2.
AVDocDidOpen
3.
AVDocDidActivate
4.
AVPageViewDidChange
In contrast, after opening a PDF document in Mac OS, notifications occur in this order:
1.
AVPageViewDidChange
2.
AVDocDidActivate
3.
AVPageViewDidChange
4.
AVDocDidOpen
This chapter contains the following information.
Registering event notifications
Register for an event notification when you want your plug-in to be notified when a specific event occurs.
For example, you can register for a notification when Acrobat or Adobe Reader is finished initializing. To
register for an event notification, you provide a callback function that Acrobat or Adobe Reader invokes
when the event occurs. To view a list of notification methods used to register an event notification, see the
Acrobat and PDF Library API Reference
.
Topic
Description
See
Registering event notifications
Describes how to register for event notifications.
page 151
Unregistering event notifications
Describes how to unregister event notifications.
page 153
