khtml Library API Documentation

DOM::MutationEvent Class Reference

Introduced in DOM Level 2. More...

#include <dom2_events.h>

Inheritance diagram for DOM::MutationEvent:

DOM::Event List of all members.

Public Types

enum  attrChangeType
 An integer indicating in which way the Attr was changed. More...


Public Methods

MutationEvent & operator= (const Event &other)
Node relatedNode () const
 relatedNode is used to identify a secondary node related to a mutation event.

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

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

DOMString attrName () const
 attrName indicates the name of the changed Attr node in a DOMAttrModified event.

unsigned short attrChange () const
 attrChange indicates the type of change which triggered the DOMAttrModified event.

void 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.


Detailed Description

Introduced in DOM Level 2.

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

Definition at line 728 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.

Definition at line 747 of file dom2_events.h.


Member Function Documentation

Node MutationEvent::relatedNode  
 

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 572 of file dom2_events.cpp.

DOMString MutationEvent::prevValue  
 

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

Definition at line 580 of file dom2_events.cpp.

DOMString MutationEvent::newValue  
 

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

Definition at line 588 of file dom2_events.cpp.

DOMString MutationEvent::attrName  
 

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

Definition at line 596 of file dom2_events.cpp.

unsigned short MutationEvent::attrChange  
 

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

The values can be MODIFICATION, ADDITION, or REMOVAL.

Definition at line 604 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 612 of file dom2_events.cpp.


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kdelibs Version 3.1.0.
Documentation copyright © 1996-2002 the KDE developers.
Generated on Wed Oct 8 12:22:45 2003 by doxygen 1.2.18 written by Dimitri van Heesch, © 1997-2001