DOM::MutationEvent Class Reference

Introduced in DOM Level 2. More...

#include <dom2_events.h>

Inheritance diagram for DOM::MutationEvent:

List of all members.

Public Types
enum	attrChangeType { MODIFICATION = 1, ADDITION = 2, REMOVAL = 3 }
Public Member Functions
	MutationEvent ()
	MutationEvent (const MutationEvent &other)
	MutationEvent (const Event &other)
virtual	~MutationEvent ()
unsigned short	attrChange () const
DOMString	attrName () const
void	initMutationEvent (const DOMString &typeArg, bool canBubbleArg, bool cancelableArg, const Node &relatedNodeArg, const DOMString &prevValueArg, const DOMString &newValueArg, const DOMString &attrNameArg, unsigned short attrChangeArg)
DOMString	newValue () const
MutationEvent &	operator= (const MutationEvent &other)
MutationEvent &	operator= (const Event &other)
DOMString	prevValue () const
Node	relatedNode () const
Protected Member Functions
	MutationEvent (MutationEventImpl *impl)

---

Detailed Description

Introduced in DOM Level 2.

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

Definition at line 778 of file dom2_events.h.

---

Member Enumeration Documentation

enum DOM::MutationEvent::attrChangeType

An integer indicating in which way the Attr was changed.

ADDITION: The Attr was just added.

MODIFICATION: The Attr was modified in place.

REMOVAL: The Attr was just removed.

Enumerator:

MODIFICATION
ADDITION
REMOVAL

Definition at line 797 of file dom2_events.h.

---

Constructor & Destructor Documentation

MutationEvent::MutationEvent

(

)

Definition at line 621 of file dom2_events.cpp.

MutationEvent::MutationEvent

(

const MutationEvent &

other

)

Definition at line 625 of file dom2_events.cpp.

MutationEvent::MutationEvent

(

const Event &

other

)

Definition at line 629 of file dom2_events.cpp.

MutationEvent::~MutationEvent

(

)

[virtual]

Definition at line 656 of file dom2_events.cpp.

MutationEvent::MutationEvent

(

MutationEventImpl *

impl

)

[protected]

Definition at line 634 of file dom2_events.cpp.

---

Member Function Documentation

unsigned short MutationEvent::attrChange

(

)

const

attrChange indicates the type of change which triggered the DOMAttrModified event.

The values can be MODIFICATION, ADDITION, or REMOVAL.

Definition at line 692 of file dom2_events.cpp.

DOMString MutationEvent::attrName

(

)

const

attrName indicates the name of the changed Attr node in a DOMAttrModified event.

Definition at line 684 of file dom2_events.cpp.

void MutationEvent::initMutationEvent	(	const DOMString &	typeArg,
		bool	canBubbleArg,
		bool	cancelableArg,
		const Node &	relatedNodeArg,
		const DOMString &	prevValueArg,
		const DOMString &	newValueArg,
		const DOMString &	attrNameArg,
		unsigned 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:

typeArg	Specifies the event type.
canBubbleArg	Specifies whether or not the event can bubble.
cancelableArg	Specifies whether or not the event's default action can be prevented.
relatedNodeArg	Specifies the Event's related Node.
prevValueArg	Specifies the Event's prevValue attribute. This value may be null.
newValueArg	Specifies the Event's newValue attribute. This value may be null.
attrNameArg	Specifies the Event's attrName attribute. This value may be null.
attrChangeArg	Specifies the Event's attrChange attribute

Definition at line 700 of file dom2_events.cpp.

DOMString MutationEvent::newValue

(

)

const

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

Definition at line 676 of file dom2_events.cpp.

MutationEvent & MutationEvent::operator=

(

const Event &

other

)

Reimplemented from DOM::Event.

Definition at line 644 of file dom2_events.cpp.

MutationEvent & MutationEvent::operator=

(

const MutationEvent &

other

)

Definition at line 638 of file dom2_events.cpp.

DOMString MutationEvent::prevValue

(

)

const

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

Definition at line 668 of file dom2_events.cpp.

Node MutationEvent::relatedNode

(

)

const

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.

Definition at line 660 of file dom2_events.cpp.

---

The documentation for this class was generated from the following files:

• dom2_events.h
• dom2_events.cpp