org.apache.batik.dom.events.AbstractEvent Maven / Gradle / Ivy
/*
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package org.apache.batik.dom.events;
import org.apache.batik.dom.xbl.OriginalEvent;
import org.w3c.dom.events.Event;
import org.w3c.dom.events.EventTarget;
import java.util.ArrayList;
import java.util.List;
/**
* The abstract Event root class.
*
* @author Thierry Kormann
* @author Stephane Hillion
* @version $Id: AbstractEvent.java 1806580 2017-08-29 12:06:44Z ssteiner $
*/
public abstract class AbstractEvent
implements Event, OriginalEvent, Cloneable {
/**
* The event type.
*/
protected String type;
/**
* Whether this event is bubbling.
*/
protected boolean isBubbling;
/**
* Whether this event is cancelable.
*/
protected boolean cancelable;
/**
* The EventTarget whose EventListeners are currently being processed.
*/
protected EventTarget currentTarget;
/**
* The target of this event.
*/
protected EventTarget target;
/**
* The event phase.
*/
protected short eventPhase;
/**
* The time the event was created.
*/
protected long timeStamp = System.currentTimeMillis();
/**
* Whether the event propagation must be stopped after the current
* event listener group has been completed.
*/
protected boolean stopPropagation = false;
/**
* Whether the event propagation must be stopped immediately.
*/
protected boolean stopImmediatePropagation = false;
/**
* Whether the default action must be processed.
*/
protected boolean preventDefault = false;
/**
* Namespace URI of this event.
*/
protected String namespaceURI;
/**
* The event from which this event was cloned for sXBL event retargetting.
*/
protected Event originalEvent;
/**
* List of default Actionables to run at the end of bubble phase.
*/
protected List defaultActions;
/**
* The number of nodes in the document this event will visit
* during capturing, bubbling and firing at the target.
* A value of 0 means to let the event be captured and bubble all
* the way to the document node. This field is used to handle
* events which should not cross sXBL shadow scopes without stopping
* or retargetting.
*/
protected int bubbleLimit = 0;
/**
* DOM: The type property represents the event name
* as a string property. The string must be an XML name.
*/
public String getType() {
return type;
}
/**
* DOM: The target property indicates the
* EventTarget whose EventListeners are
* currently being processed.
*/
public EventTarget getCurrentTarget() {
return currentTarget;
}
/**
* DOM: The target property indicates the
* EventTarget to which the event was originally
* dispatched.
*/
public EventTarget getTarget() {
return target;
}
/**
* DOM: The eventPhase property indicates which phase
* of event flow is currently being evaluated.
*/
public short getEventPhase() {
return eventPhase;
}
/**
* DOM: The bubbles property indicates whether or not
* an event is a bubbling event. If the event can bubble the
* value is true, else the value is false.
*/
public boolean getBubbles() {
return isBubbling;
}
/**
* DOM: The cancelable property indicates whether or
* not an event can have its default action prevented. If the
* default action can be prevented the value is true, else the
* value is false.
*/
public boolean getCancelable() {
return cancelable;
}
/**
* DOM: Used to specify the time (in milliseconds relative to the
* epoch) at
* which the event was created. Due to the fact that some systems may not
* provide this information the value of timeStamp may be
* returned. Examples of epoch time are the time of the system start or
* 0:0:0 UTC 1st January 1970.
*/
public long getTimeStamp() {
return timeStamp;
}
/**
* Get the namespace URI of this event.
*/
public String getNamespaceURI() {
return namespaceURI;
}
/**
* Gets the event from which this event was cloned.
*/
public Event getOriginalEvent() {
return originalEvent;
}
/**
* DOM: The stopPropagation method is used prevent
* further propagation of an event during event flow. If this
* method is called by any EventListener the event
* will cease propagating through the tree. The event will
* complete dispatch to all listeners on the current
* EventTarget before event flow stops. This method
* may be used during any stage of event flow.
*/
public void stopPropagation() {
this.stopPropagation = true;
}
/**
* DOM: If an event is cancelable, the preventDefault
* method is used to signify that the event is to be canceled,
* meaning any default action normally taken by the implementation
* as a result of the event will not occur. If, during any stage
* of event flow, the preventDefault method is called
* the event is canceled. Any default action associated with the
* event will not occur. Calling this method for a non-cancelable
* event has no effect. Once preventDefault has been
* called it will remain in effect throughout the remainder of the
* event's propagation. This method may be used during any stage
* of event flow.
*/
public void preventDefault() {
this.preventDefault = true;
}
/**
* DOM: Returns whether preventDefault has been
* called on this object.
*/
public boolean getDefaultPrevented() {
return preventDefault;
}
/**
* Returns the current list of default action runnables
*/
public List getDefaultActions() { return defaultActions; }
/**
* Adds the runnable to the list of default action runnables
*/
public void addDefaultAction(Runnable rable) {
if (defaultActions == null) defaultActions = new ArrayList();
defaultActions.add(rable);
}
/**
* DOM: Stops propagation of this event immediately, even to
* listeners in the current group.
*/
public void stopImmediatePropagation() {
this.stopImmediatePropagation = true;
}
/**
* DOM: The initEvent method is used to initialize the
* value of interface. This method may only be called before the
* Event 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. If called from a subclass of
* Event interface only the values specified in the
* initEvent method are modified, all other attributes are
* left unchanged.
* @param eventTypeArg Specifies 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.
* @param canBubbleArg Specifies whether or not the event can bubble.
* @param cancelableArg Specifies whether or not the event's default
* action can be prevented.
*/
public void initEvent(String eventTypeArg,
boolean canBubbleArg,
boolean cancelableArg) {
this.type = eventTypeArg;
this.isBubbling = canBubbleArg;
this.cancelable = cancelableArg;
}
/**
* DOM: Implements
* org.w3c.dom.events.Event#initEventNS(String,String,boolean,boolean).
*/
public void initEventNS(String namespaceURIArg,
String eventTypeArg,
boolean canBubbleArg,
boolean cancelableArg) {
if (namespaceURI != null && namespaceURI.length() == 0) {
namespaceURI = null;
}
namespaceURI = namespaceURIArg;
type = eventTypeArg;
isBubbling = canBubbleArg;
cancelable = cancelableArg;
}
boolean getStopPropagation() {
return stopPropagation;
}
boolean getStopImmediatePropagation() {
return stopImmediatePropagation;
}
void setEventPhase(short eventPhase) {
this.eventPhase = eventPhase;
}
void stopPropagation(boolean state) {
this.stopPropagation = state;
}
void stopImmediatePropagation(boolean state) {
this.stopImmediatePropagation = state;
}
void preventDefault(boolean state) {
this.preventDefault = state;
}
void setCurrentTarget(EventTarget currentTarget) {
this.currentTarget = currentTarget;
}
void setTarget(EventTarget target) {
this.target = target;
}
/**
* Returns a new Event with the same field values as this object.
*/
public Object clone() throws CloneNotSupportedException {
AbstractEvent newEvent = (AbstractEvent) super.clone();
newEvent.timeStamp = System.currentTimeMillis();
return newEvent;
}
/**
* Clones this event and sets the originalEvent field of the new event
* to be equal to this event.
*/
public AbstractEvent cloneEvent() {
try {
AbstractEvent newEvent = (AbstractEvent) clone();
newEvent.originalEvent = this;
return newEvent;
} catch (CloneNotSupportedException e) {
return null;
}
}
/**
* Returns the bubble limit for this event.
*/
public int getBubbleLimit() {
return bubbleLimit;
}
/**
* Set the number of nodse this event will visit.
*/
public void setBubbleLimit(int n) {
bubbleLimit = n;
}
}