Programmer's Guide > Programming and Scripting Techniques > Events > Event Types > ADocumentEntityEvent Module
  
ADocumentEntityEvent Module
The ADocumentEntityEvent extension to the Event interface includes the following event type:
EntityDeclConflict
The EntityDeclConflict event occurs when an entity declaration in an internal subset conflicts with one in an external subset (usually a DTD) or with one in a referencing parent document. This event type is similar to the entitydeclconflict ACL callback.
The following module properties provide the context information for this event:
object
The CMSObject in which the declaration was found.
relatedDocument
The Document in which the declaration was found.
relatedNode
DOM Entity containing information about the entity declaration.
To avoid the default behavior (which is to ignore the conflicting entity declaration), the event handler must set the result property to specify an alternative entity name as well as call preventDefault. Even if result is set and preventDefaultis called, the conflicting declaration will still be ignored if any of the following are true:
result was set to a blank or null string.
result was set to a name which conflicts with an already existing entity.
result was set to an invalid entity name.
* 
Setting result without calling preventDefault will cause the result to be ignored and the default processing to proceed.
Bubbles: Yes
Cancelable: Yes
Context Info: object, relatedDocument, relatedNode