⇒ Index (Frames) |  ⇒ Index (No Frames) |  ⇒ Package |  ⇒ Package Tree |  ⇒ Full Tree 
gnu.xml.dom

Class DomEvent

java.lang.Object
|
+--gnu.xml.dom.DomEvent

All Implemented Interfaces:
Event

Known Direct Subclasses:
DomEvent.DomMutationEvent, DomEvent.DomUIEvent


public class DomEvent
extends java.lang.Object
implements Event

"Event" implementation. Events are created (through DocumentEvent interface methods on the document object), and are sent to any target node in the document.

Applications may define application specific event subclasses, but should otherwise use the DocumentTraversal interface to acquire event objects.

Author:
David Brownell

Constructor Summary

DomEvent(java.lang.String type)

Constructs, but does not initialize, an event.

Method Summary

boolean

getBubbles()

Returns true if the news of the event bubbles to tree tops (as specified during initialization).

boolean

getCancelable()

Returns true if the default handling may be canceled (as specified during initialization).

EventTarget

getCurrentTarget()

Returns the target to which events are currently being delivered.

short

getEventPhase()

Returns CAPTURING_PHASE, AT_TARGET, or BUBBLING; only meaningful within EventListener.handleEvent

EventTarget

getTarget()

Returns event's target; delivery of an event is initiated by a target.dispatchEvent(event) invocation.

long

getTimeStamp()

Returns the event's timestamp.

java.lang.String

getType()

Returns the event's type (name) as initialized

void

initEvent(java.lang.String typeArg, boolean canBubbleArg, boolean cancelableArg)

Initializes basic event state.

void

preventDefault()

Requests that whoever dispatched the event not perform their default processing when event delivery completes.

void

stopPropagation()

Requests the event no longer be captured or bubbled; only listeners on the event target will see the event, if they haven't yet been notified.

java.lang.String

toString()

Returns a basic printable description of the event's type, state, and delivery conditions

Constructor Details

DomEvent

public DomEvent(java.lang.String type)

Constructs, but does not initialize, an event.

Parameters:
type

Method Details

getBubbles

public final boolean getBubbles()

Returns true if the news of the event bubbles to tree tops (as specified during initialization).


getCancelable

public final boolean getCancelable()

Returns true if the default handling may be canceled (as specified during initialization).


getCurrentTarget

public final EventTarget getCurrentTarget()

Returns the target to which events are currently being delivered. When capturing or bubbling, this will not be what getTarget returns.


getEventPhase

public final short getEventPhase()

Returns CAPTURING_PHASE, AT_TARGET, or BUBBLING; only meaningful within EventListener.handleEvent


getTarget

public final EventTarget getTarget()

Returns event's target; delivery of an event is initiated by a target.dispatchEvent(event) invocation.


getTimeStamp

public final long getTimeStamp()

Returns the event's timestamp.


getType

public final String getType()

Returns the event's type (name) as initialized


initEvent

public void initEvent(java.lang.String typeArg, boolean canBubbleArg, boolean cancelableArg)

Initializes basic event state.

Parameters:
typeArg
canBubbleArg
cancelableArg

preventDefault

public final void preventDefault()

Requests that whoever dispatched the event not perform their default processing when event delivery completes. Initializes event timestamp.


stopPropagation

public void stopPropagation()

Requests the event no longer be captured or bubbled; only listeners on the event target will see the event, if they haven't yet been notified.

Avoid using this except for application-specific events, for which you the protocol explicitly "blesses" the use of this with some event types. Otherwise, you are likely to break algorithms which depend on event notification either directly or through bubbling or capturing.

Note that this method is not final, specifically to enable enforcing of policies about events always propagating.


toString

public String toString()

Returns a basic printable description of the event's type, state, and delivery conditions