A monad providing access to data in an event.

A tag for events that do not carry any event-specific information.

A tag for key events.

A tag for Button events.

A tag for Scroll events.

A tag for Motion events.

A tag for Expose events.

A tag for Visibility events.

A tag for Crossing events.

A tag for Focus events.

A tag for Configure events.

A tag for Property events.

A tag for Proximity events.

A tag for WindowState event.

A tag for OwnerChange events.

A tag for GrabBroken events.

Retrieve the DrawWindow that this event relates to.

Query if this event was sent sent explicitly by the application (rather than being generated by human interaction).

Retrieve the (x,y) coordinates of the mouse.

Retrieve the (x,y) coordinates of the mouse relative to the root (origin) of the screen.

Query the modifier keys that were depressed when the event happened. Sticky modifiers such as CapsLock are omitted in the return value. Use eventModifierAll your application requires all modifiers. Use eventModifierMouse if you just need the mouse buttons.

Query the modifier keys that were depressed when the event happened. The result includes sticky modifiers such as CapsLock. Normally, eventModifier is more appropriate in applications.

Query the mouse buttons that were depressed when the event happened.

Query the time when the event occurred.

The key value. See KeyVal.

The key value as a string. See KeyVal.

The hardware key code.

The keyboard group.

Query the mouse buttons.

Type of mouse click

in which direction was scrolled?

Query the direction of scrolling.

Check if the motion event is only a hint rather than the full mouse movement information.

Request more motion notifies if this event is a motion notify hint event.

This action should be used instead of drawWindowGetPointer to request further motion notifies, because it also works for extension events where motion notifies are provided for devices other than the core pointer.

Coordinate extraction, processing and requesting more motion events from a motionNotifyEvent usually works like this:

on widget motionNotifyEvent $ do
  (x, y) <- eventCoordinates
  -- handle the x,y motion:
  ...
  -- finally, notify that we are ready to get more motion events:
  eventRequestMotions

Query a bounding box of the region that needs to be updated.

Query the region that needs to be updated. Removed in Gtk3.

Get the visibility status of a window.

How focus is crossing the widget.

Get the mode of the mouse cursor crossing a window.

Information on from what level of the widget hierarchy the mouse cursor came.

NotifyAncestor

The window is entered from an ancestor or left towards an ancestor.

NotifyVirtual

The pointer moves between an ancestor and an inferior of the window.

NotifyInferior

The window is entered from an inferior or left towards an inferior.

NotifyNonlinear

The window is entered from or left towards a window which is neither an ancestor nor an inferior.

NotifyNonlinearVirtual

The pointer moves between two windows which are not ancestors of each other and the window is part of the ancestor chain between one of these windows and their least common ancestor.

NotifyUnknown

The level change does not fit into any of the other categories or could not be determined.

Get the notify type of the mouse cursor crossing a window.

Query if the window has the focus or is an inferior window.

Query if a window gained focus (True) or lost the focus (False).

Get the (x,y) position of the window within the parent window.

Get the new size of the window as (width,height).

The state a DrawWindow is in.

Query which window state bits have changed.

Query the new window state.

Query why a seleciton changed its owner.

Query what selection changed its owner.

Query the time when the selection was taken over.

Check if a keyboard (True) or a mouse pointer grap (False) was broken.

Check if a grab was broken implicitly.

Get the new window that owns the grab or Nothing if the window is not part of this application.

Keyboard modifiers that are depressed when the user presses a key or a mouse button.

• This data type is used to build lists of modifers that were active during an event.
• The Apple key on Macintoshs is mapped to Alt2 and the Meta key (if available).
• Since Gtk 2.10, there are also Super, Hyper and Meta modifiers which are simply generated from Alt .. Compose modifier keys, depending on the mapping used by the windowing system. Due to one key being mapped to e.g. Alt2 and Meta, you shouldn't pattern match directly against a certain key but check whether a key is in the list using the elem function, say.

The time (in milliseconds) when an event happened. This is used mostly for ordering events and responses to events.

Represents the current time, and can be used anywhere a time is expected.

Execute an event handler and assume it handled the event unless it threw a pattern match exception or calls mzero (e.g. via guard).

Explicitly stop the handling of an event. This function should only be called inside a handler that is wrapped with tryEvent. (It merely throws a bogus pattern matching error which tryEvent interprets as if the handler does not handle the event.)