|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--gnu.xml.dom.DomEvent
"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.
Inner Class Summary | |
static class |
DomEvent.DomMutationEvent
"MutationEvent" implementation. |
static class |
DomEvent.DomUIEvent
"UIEvent" implementation. |
Fields inherited from interface org.w3c.dom.events.Event |
AT_TARGET, BUBBLING_PHASE, CAPTURING_PHASE |
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). |
org.w3c.dom.events.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 |
org.w3c.dom.events.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 |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
public DomEvent(java.lang.String type)
Method Detail |
public final java.lang.String getType()
getType
in interface org.w3c.dom.events.Event
public final org.w3c.dom.events.EventTarget getTarget()
getTarget
in interface org.w3c.dom.events.Event
public final org.w3c.dom.events.EventTarget getCurrentTarget()
getCurrentTarget
in interface org.w3c.dom.events.Event
public final short getEventPhase()
getEventPhase
in interface org.w3c.dom.events.Event
public final boolean getBubbles()
getBubbles
in interface org.w3c.dom.events.Event
public final boolean getCancelable()
getCancelable
in interface org.w3c.dom.events.Event
public final long getTimeStamp()
getTimeStamp
in interface org.w3c.dom.events.Event
public void stopPropagation()
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.
stopPropagation
in interface org.w3c.dom.events.Event
public final void preventDefault()
preventDefault
in interface org.w3c.dom.events.Event
public void initEvent(java.lang.String typeArg, boolean canBubbleArg, boolean cancelableArg)
initEvent
in interface org.w3c.dom.events.Event
org.w3c.dom.events.Event
eventTypeArgSpecifies
- the event type. This type may be any
event type currently defined in this specification or a new event
type.. The string must be an XML name. Any new event type must not
begin with any upper, lower, or mixed case version of the string
"DOM". This prefix is reserved for future DOM event sets. It is
also strongly recommended that third parties adding their own
events use their own prefix to avoid confusion and lessen the
probability of conflicts with other new events.canBubbleArgSpecifies
- whether or not the event can bubble.cancelableArgSpecifies
- whether or not the event's default
action can be prevented.public java.lang.String toString()
toString
in class java.lang.Object
|
Source code is GPL'd in the JAXP subproject at http://savannah.gnu.org/projects/classpathx |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |