About event properties and event propagation. Adobe InCopy CS6

Events Understanding the event scripting model 80

User-Interface event

Revert

Save

Save A Copy

Save As

Event name beforeRevert afterRevert beforeSave afterSave beforeSaveACopy afterSaveACopy beforeSaveAs afterSaveAs

Description

Appears after a document revert request is made but before the document is reverted to an earlier saved state.

Object type

DocumentEvent

Appears after a document is reverted to an earlier saved state.

DocumentEvent

DocumentEvent Appears after a save document request is made but before the document is saved.

Appears after a document is saved.

DocumentEvent

DocumentEvent Appears after a document save-a-copy-as request is made but before the document is saved.

Appears after a document is saved.

DocumentEvent

DocumentEvent Appears after a document save-as request is made but before the document is saved.

Appears after a document is saved.

DocumentEvent

About event properties and event propagation

When an action—whether initiated by a user or by a script—triggers an event, the event can spread, or propagate , through the scripting objects capable of responding to the event. When an event reaches an object that has an

EventListener

registered for that event, the

EventListener

is triggered by the event.

An event can be handled by more than one object as it propagates.

There are three types of event propagation:

 None — Only the

EventListeners

registered to the event target are triggered by the event. The beforeDisplay

event is an example of an event that does not propagate.

 Capturing — The event starts at the top of the scripting object model—the application—then propagates through the model to the target of the event. Any

EventListeners

capable of responding to the event registered to objects above the target

will process the event.

 Bubbling — The event starts propagation at its target

and triggers any qualifying

EventListeners registered to the target

. The event then proceeds upward through the scripting object model, triggering any qualifying EventListeners registered to objects above the target in the scripting object model hierarchy.

The following table provides more detail on the properties of an event and the ways in which they relate to event propagation through the scripting object model.