org.gnome.gdk

## Class EventType

- Object
- - org.freedesktop.bindings.Constant
  - - org.gnome.gdk.EventType

-     public final class EventType
      extends org.freedesktop.bindings.Constant

  The type of a low-level Event received. Although an `Event` is delivered as a parameter of many signals (the "event" signals, in fact), in general you will rarely need to make use of their information.

  WARNING Many of these constants are clearly internal. There's a strong argument to be made that some or all of these should not be publicly visible.

  TODO Most of these descriptions are terribly sparse and copied from the underlying documentation. Ordinarily we wouldn't do that, but with any luck you'll not need to be using these classes directly. If anyone has further information on the detailed significance of these constants, please contribute improvements to this class.

  This is principally used to discriminate what kind of concrete Event subclass to create. Note that we are in GDK here; These events refer to the low level constructs delivered to the `GdkWindow`s that underlie Widgets.

  Since:
    4.0.3
  Author:
    Andrew Cowie

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `static EventType` | `BUTTON_PRESS` A mouse button has been pressed.
    `static EventType` | `BUTTON_PRESS_DOUBLE` A mouse button has been double clicked.
    `static EventType` | `BUTTON_PRESS_TRIPLE` A mouse button has been clicked three times in a brief period.
    `static EventType` | `BUTTON_RELEASE` A previously pressed mouse button has been released.
    `static EventType` | `CLIENT_EVENT` A message has been received from another application (TODO meaning what?).
    `static EventType` | `CONFIGURE` The size, position, or stacking order of a Window has been changed.
    `static EventType` | `DELETE` The top level Window should be hidden or destroyed, presumably due to the user having clicked the close window button presented in the window manager's decorations.
    `static EventType` | `DESTROY` The Window has been destroyed.
    `static EventType` | `DRAG_ENTER` The pointer has entered the Window during a drag operation.
    `static EventType` | `DRAG_LEAVE` The pointer has left the Window during a drag operation.
    `static EventType` | `DRAG_MOTION` The pointer has moved within the Window during a drag operation (why would you ever care?).
    `static EventType` | `DRAG_STATUS` The status of a drag operation initiated by this Window has changed (TODO to?).
    `static EventType` | `DROP_FINISHED` The drop operation initiated by the Window has been completed.
    `static EventType` | `DROP_START` A drop operation onto this Window has started.
    `static EventType` | `ENTER_NOTIFY` The pointer has entered a Window.
    `static EventType` | `EXPOSE` Part or all of the Window needs to be redrawn due to its having become visible.
    `static EventType` | `FOCUS_CHANGE` The keyboard focus has entered or left the Window.
    `static EventType` | `KEY_PRESS` A key has been pressed.
    `static EventType` | `KEY_RELEASE` A key has been released
    `static EventType` | `LEAVE_NOTIFY` The pointer has left a Window.
    `static EventType` | `MAP` The Window has been mapped to the screen.
    `static EventType` | `MOTION_NOTIFY` The pointer has moved.
    `static EventType` | `NO_EXPOSE` The source region was completely available when parts of a drawable were copied.
    `static EventType` | `PROPERTY_NOTIFY` A low level [ie X-windows] property of the Window has been changed or removed.
    `static EventType` | `PROXIMITY_IN` An input device has moved into contact with a sensing surface (e.g. a touchscreen or graphics tablet).
    `static EventType` | `PROXIMITY_OUT` An input device has moved out of contact with a sensing surface, whatever that actually means.
    `static EventType` | `SCROLL` The scroll wheel was turned.
    `static EventType` | `SELECTION_CLEAR` The application has been told that it no longer owns a selection.
    `static EventType` | `SELECTION_NOTIFY` A selection has been received (from another application?).
    `static EventType` | `SELECTION_REQUEST` Another application has requested a selection.
    `static EventType` | `SETTING` A setting (TODO what kind of setting?)
    `static EventType` | `UNMAP` The Window has been unmapped from the screen.
    `static EventType` | `VISIBILITY_NOTIFY` The Window's visibility status has changed (TODO meaning what?)
    `static EventType` | `WINDOW_STATE` The `state` of a Window has changed.

  - ### Method Summary

    - ### Methods inherited from class org.freedesktop.bindings.Constant

      `toString`

    - ### Methods inherited from class Object

      `equals, getClass, hashCode, notify, notifyAll, wait, wait, wait`

- - ### Field Detail

    - #### BUTTON_PRESS

          public static final EventType BUTTON_PRESS

      A mouse button has been pressed. As you would expect, an Event having this EventType will be a `EventButton`.

    - #### BUTTON_PRESS_DOUBLE

          public static final EventType BUTTON_PRESS_DOUBLE

      A mouse button has been double clicked. Each click should also have generated a `BUTTON_PRESS` event; regardless this will be handled in higher level semantics.

      Note that this is the constant `GDK_2BUTTON_PRESS` in the underlying library; we had to rename it slightly for translation into a legal Java identifier.

    - #### BUTTON_PRESS_TRIPLE

          public static final EventType BUTTON_PRESS_TRIPLE

      A mouse button has been clicked three times in a brief period. You would probably see this generated from the sequence:
      - click (`BUTTON_PRESS` emitted),
      - click (`BUTTON_PRESS` then `BUTTON_PRESS_DOUBLE` emitted),
      - click (`BUTTON_PRESS` then `BUTTON_PRESS_TRIPLE` emitted).
      Your results may vary, however, depending on what else might be intercepting events along the way.

      Note that this is the constant `GDK_3BUTTON_PRESS` in the underlying library; we had to rename it slightly for translation into a legal Java identifier.

    - #### BUTTON_RELEASE

          public static final EventType BUTTON_RELEASE

      A previously pressed mouse button has been released. This EventType will be found in a `EventButton` Event.

    - #### CLIENT_EVENT

          public static final EventType CLIENT_EVENT

      A message has been received from another application (TODO meaning what?).

    - #### CONFIGURE

          public static final EventType CONFIGURE

      The size, position, or stacking order of a Window has been changed. Apparently GTK discards these events for child Windows, but then you won't notice this because you're not using these constants directly anyway, right?

    - #### DELETE

          public static final EventType DELETE

      The top level Window should be hidden or destroyed, presumably due to the user having clicked the close window button presented in the window manager's decorations.

    - #### DESTROY

          public static final EventType DESTROY

      The Window has been destroyed.

    - #### DRAG_ENTER

          public static final EventType DRAG_ENTER

      The pointer has entered the Window during a drag operation.

    - #### DRAG_LEAVE

          public static final EventType DRAG_LEAVE

      The pointer has left the Window during a drag operation.

    - #### DRAG_MOTION

          public static final EventType DRAG_MOTION

      The pointer has moved within the Window during a drag operation (why would you ever care?).

    - #### DRAG_STATUS

          public static final EventType DRAG_STATUS

      The status of a drag operation initiated by this Window has changed (TODO to?).

    - #### DROP_FINISHED

          public static final EventType DROP_FINISHED

      The drop operation initiated by the Window has been completed.

    - #### DROP_START

          public static final EventType DROP_START

      A drop operation onto this Window has started.

    - #### ENTER_NOTIFY

          public static final EventType ENTER_NOTIFY

      The pointer has entered a Window. This corresponds to `EventCrossing`.

    - #### EXPOSE

          public static final EventType EXPOSE

      Part or all of the Window needs to be redrawn due to its having become visible.

    - #### FOCUS_CHANGE

          public static final EventType FOCUS_CHANGE

      The keyboard focus has entered or left the Window.

    - #### KEY_PRESS

          public static final EventType KEY_PRESS

      A key has been pressed.

    - #### KEY_RELEASE

          public static final EventType KEY_RELEASE

      A key has been released

    - #### LEAVE_NOTIFY

          public static final EventType LEAVE_NOTIFY

      The pointer has left a Window. This corresponds to `EventCrossing`.

    - #### MAP

          public static final EventType MAP

      The Window has been mapped to the screen.

    - #### MOTION_NOTIFY

          public static final EventType MOTION_NOTIFY

      The pointer has moved.

    - #### NO_EXPOSE

          public static final EventType NO_EXPOSE

      The source region was completely available when parts of a drawable were copied. "This is not very useful" says the underlying API documentation. Really!

    - #### PROPERTY_NOTIFY

          public static final EventType PROPERTY_NOTIFY

      A low level [ie X-windows] property of the Window has been changed or removed.

    - #### PROXIMITY_IN

          public static final EventType PROXIMITY_IN

      An input device has moved into contact with a sensing surface (e.g. a touchscreen or graphics tablet).

    - #### PROXIMITY_OUT

          public static final EventType PROXIMITY_OUT

      An input device has moved out of contact with a sensing surface, whatever that actually means.

    - #### SCROLL

          public static final EventType SCROLL

      The scroll wheel was turned.

    - #### SELECTION_CLEAR

          public static final EventType SELECTION_CLEAR

      The application has been told that it no longer owns a selection.

    - #### SELECTION_NOTIFY

          public static final EventType SELECTION_NOTIFY

      A selection has been received (from another application?).

    - #### SELECTION_REQUEST

          public static final EventType SELECTION_REQUEST

      Another application has requested a selection.

    - #### SETTING

          public static final EventType SETTING

      A setting (TODO what kind of setting?) has been modified.

    - #### UNMAP

          public static final EventType UNMAP

      The Window has been unmapped from the screen.

    - #### VISIBILITY_NOTIFY

          public static final EventType VISIBILITY_NOTIFY

      The Window's visibility status has changed (TODO meaning what?)

    - #### WINDOW_STATE

          public static final EventType WINDOW_STATE

      The `state` of a Window has changed.