GdomeCppSmartDOM::MutationEvent

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



Inherits from
Event


Default Constructor
MutationEvent(GdomeMutationEvent* = 0)
Creates a smart pointer for the Gdome element whose pointer is passed as an argument. The user should never pass a non-null pointer to this constructor.


Copy and Cast Constructors
MutationEvent(const MutationEvent&)
MutationEvent(const Event&)
These constructors can be used to copy a smart pointer or to downcast it. If the downcasting is not possible, the resulting smart pointer will be null.


Copy Operator
MutationEvent& operator=(const MutationEvent&)


Equality
bool operator==(const MutationEvent&) const
bool operator!=(const MutationEvent&) const
Two smart pointers are equal if they point to the same Gdome object.


Constants
MODIFICATION = 1
ADDITION = 2
REMOVAL = 3


Attributes
Node get_relatedNode(void) 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.

DOMString get_prevValue(void) const

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

DOMString get_newValue(void) const

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

DOMString get_attrName(void) const

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

unsigned short get_attrChange(void) const

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



Methods
void initMutationEvent(const DOMString& typeArg, const boolcanBubbleArg, const boolcancelableArg, const Node& relatedNodeArg, const DOMString& prevValueArg, const DOMString& newValueArg, const DOMString& attrNameArg, const unsigned shortattrChangeArg)
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

newValueArg

Specifies the Event's newValue attribute

attrNameArg

Specifies the Event's attrName attribute

attrChangeArg

Specifies the Event's attrName attribute

Description:

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.


This file has been generated automatically on Tue Nov 27 17:13:15 EST 2001 as part of GMetaDOM. For more information see the home page of the project, or contact the main author: luca.padovani@cs.unibo.it.