org.w3c.dom.events
Interface MutationEvent

All Superinterfaces:
Event

public interface MutationEvent
extends Event

The MutationEvent interface provides specific contextual information associated with Mutation events.

See also the Document Object Model (DOM) Level 2 Events Specification.

Since:
BlackBerry API 4.6.0, DOM Level 2

Field Summary
static short ADDITION
          The Attr was just added.
static short MODIFICATION
          The Attr was modified in place.
static short REMOVAL
          The Attr was just removed.
 
Fields inherited from interface org.w3c.dom.events.Event
AT_TARGET, BUBBLING_PHASE, CAPTURING_PHASE
 
Method Summary
 short getAttrChange()
          attrChange indicates the type of change which triggered the DOMAttrModified event.
 String getAttrName()
          attrName indicates the name of the changed Attr node in a DOMAttrModified event.
 String getNewValue()
          newValue indicates the new value of the Attr node in DOMAttrModified events, and of the CharacterData node in DOMCharDataModified events.
 String getPrevValue()
          prevValue indicates the previous value of the Attr node in DOMAttrModified events, and of the CharacterData node in DOMCharDataModified events.
 Node getRelatedNode()
          relatedNode is used to identify a secondary node related to a mutation event.
 void initMutationEvent(String typeArg, boolean canBubbleArg, boolean cancelableArg, Node relatedNodeArg, String prevValueArg, String newValueArg, String attrNameArg, short attrChangeArg)
          The initMutationEvent method is used to initialize the value of a MutationEvent created through the DocumentEvent interface.
 
Methods inherited from interface org.w3c.dom.events.Event
getBubbles, getCancelable, getCurrentTarget, getEventPhase, getTarget, getTimeStamp, getType, initEvent, preventDefault, stopPropagation
 



Field Detail

MODIFICATION

static final short MODIFICATION
The Attr was modified in place.

See Also:
Constant Field Values
Since:
BlackBerry API 4.6.0

ADDITION

static final short ADDITION
The Attr was just added.

See Also:
Constant Field Values
Since:
BlackBerry API 4.6.0

REMOVAL

static final short REMOVAL
The Attr was just removed.

See Also:
Constant Field Values
Since:
BlackBerry API 4.6.0


Method Detail

getRelatedNode

Node getRelatedNode()
relatedNode is used to identify a secondary node related to a mutation event. For example, if a mutation event is dispatched to a node indicating that its parent has changed, the relatedNode is the changed parent. If an event is instead dispatched to a subtree indicating a node was changed within it, the relatedNode is the changed node. In the case of the DOMAttrModified event it indicates the Attr node which was modified, added, or removed.

Since:
BlackBerry API 4.6.0

getPrevValue

String getPrevValue()
prevValue indicates the previous value of the Attr node in DOMAttrModified events, and of the CharacterData node in DOMCharDataModified events.

Since:
BlackBerry API 4.6.0

getNewValue

String getNewValue()
newValue indicates the new value of the Attr node in DOMAttrModified events, and of the CharacterData node in DOMCharDataModified events.

Since:
BlackBerry API 4.6.0

getAttrName

String getAttrName()
attrName indicates the name of the changed Attr node in a DOMAttrModified event.

Since:
BlackBerry API 4.6.0

getAttrChange

short getAttrChange()
attrChange indicates the type of change which triggered the DOMAttrModified event. The values can be MODIFICATION , ADDITION, or REMOVAL.

Since:
BlackBerry API 4.6.0

initMutationEvent

void initMutationEvent(String typeArg,
                       boolean canBubbleArg,
                       boolean cancelableArg,
                       Node relatedNodeArg,
                       String prevValueArg,
                       String newValueArg,
                       String attrNameArg,
                       short attrChangeArg)
The initMutationEvent method is used to initialize the value of a MutationEvent created through the DocumentEvent interface. This method may only be called before the MutationEvent has been dispatched via the dispatchEvent method, though it may be called multiple times during that phase if necessary. If called multiple times, the final invocation takes precedence.

Parameters:
typeArgSpecifies - the event type.
canBubbleArgSpecifies - whether or not the event can bubble.
cancelableArgSpecifies - whether or not the event's default action can be prevented.
relatedNodeArgSpecifies - the Event's related Node.
prevValueArgSpecifies - the Event's prevValue attribute. This value may be null.
newValueArgSpecifies - the Event's newValue attribute. This value may be null.
attrNameArgSpecifies - the Event's attrName attribute. This value may be null.
attrChangeArgSpecifies - the Event's attrChange attribute
Since:
BlackBerry API 4.6.0





Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.