gnu.xml.dom
Class DomEvent
- 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.
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.
|
String | getType() - Returns the event's type (name) as initialized
|
void | initEvent(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.
|
String | toString() - Returns a basic printable description of the event's type,
state, and delivery conditions
|
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait |
DomEvent
public DomEvent(String type)
Constructs, but does not initialize, an event.
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(String typeArg,
boolean canBubbleArg,
boolean cancelableArg)
Initializes basic event state.
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
- toString in interface Object
DomEvent.java --
Copyright (C) 1999,2000,2001 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version.