Module javafx.base
Package javafx.event

Class EventType<T extends Event>

java.lang.Object
javafx.event.EventType<T>
Type Parameters:
T - the event class to which this type applies
All Implemented Interfaces:
Serializable

public final class EventType<T extends Event>
extends Object
implements Serializable
This class represents a specific event type associated with an Event.

Event types form a hierarchy with the ROOT (equals to Event.ANY) as its root. This is useful in event filter / handler registration where a single event filter / handler can be registered to a super event type and will be receiving its sub type events as well. Note that you cannot construct two different EventType objects with the same name and parent.

Note about deserialization: All EventTypes that are going to be deserialized (e.g. as part of Event deserialization), need to exist at the time of deserialization. Deserialization of EventType will not create new EventType objects.

Since:
JavaFX 2.0
See Also:
Serialized Form
  • Field Summary

    Fields 
    Modifier and Type Field Description
    static EventType<Event> ROOT
    The root event type.
  • Constructor Summary

    Constructors 
    Constructor Description
    EventType()
    Deprecated.
    Do not use this constructor, as only one such EventType can exist
    EventType​(String name)
    Constructs a new EventType with the specified name and the EventType.ROOT as its super type.
    EventType​(EventType<? super T> superType)
    Constructs a new EventType with the specified super type and the name set to null.
    EventType​(EventType<? super T> superType, String name)
    Constructs a new EventType with the specified super type and name.
  • Method Summary

    Modifier and Type Method Description
    String getName()
    Gets the name of this event type.
    EventType<? super T> getSuperType()
    Gets the super type of this event type.
    String toString()
    Returns a string representation of this EventType object.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
  • Field Details

    • ROOT

      public static final EventType<Event> ROOT
      The root event type. All other event types are either direct or indirect sub types of it. It is also the only event type which has its super event type set to null.
  • Constructor Details

    • EventType

      @Deprecated public EventType()
      Deprecated.
      Do not use this constructor, as only one such EventType can exist
      Constructs a new EventType with the EventType.ROOT as its super type and the name set to null.
    • EventType

      public EventType​(String name)
      Constructs a new EventType with the specified name and the EventType.ROOT as its super type.
      Parameters:
      name - the name
      Throws:
      IllegalArgumentException - if an EventType with the same name and ROOT/Event.ANY as parent
    • EventType

      public EventType​(EventType<? super T> superType)
      Constructs a new EventType with the specified super type and the name set to null.
      Parameters:
      superType - the event super type
      Throws:
      IllegalArgumentException - if an EventType with "null" name and under this supertype exists
    • EventType

      public EventType​(EventType<? super T> superType, String name)
      Constructs a new EventType with the specified super type and name.
      Parameters:
      superType - the event super type
      name - the name
      Throws:
      IllegalArgumentException - if an EventType with the same name and superType exists
  • Method Details

    • getSuperType

      public final EventType<? super T> getSuperType()
      Gets the super type of this event type. The returned value is null only for the EventType.ROOT.
      Returns:
      the super type
    • getName

      public final String getName()
      Gets the name of this event type.
      Returns:
      the name
    • toString

      public String toString()
      Returns a string representation of this EventType object.
      Overrides:
      toString in class Object
      Returns:
      a string representation of this EventType object.