GI.Gdk.Objects.Event

The GdkEvent struct contains only private fields and should not be accessed directly.

Exported types

newtype Event

Memory-managed wrapper type.

Constructors

Event (ManagedPtr Event)

Instances

Eq Event

Defined in GI.Gdk.Objects.Event

Methods

(==) :: Event -> Event -> Bool

(/=) :: Event -> Event -> Bool

BoxedPtr Event

Defined in GI.Gdk.Objects.Event

Methods

boxedPtrCopy :: Event -> IO Event

boxedPtrFree :: Event -> IO ()

ManagedPtrNewtype Event

Defined in GI.Gdk.Objects.Event

Methods

toManagedPtr :: Event -> ManagedPtr Event

TypedObject Event

Defined in GI.Gdk.Objects.Event

Methods

glibType :: IO GType

HasParentTypes Event

Defined in GI.Gdk.Objects.Event

type ParentTypes Event

Defined in GI.Gdk.Objects.Event

type ParentTypes Event = '[] :: [Type]

class (BoxedPtr o, TypedObject o, IsDescendantOf Event o) => IsEvent o

Type class for types which can be safely cast to Event, for instance with toEvent.

Instances

(BoxedPtr o, TypedObject o, IsDescendantOf Event o) => IsEvent o

Defined in GI.Gdk.Objects.Event

toEvent :: (MonadIO m, IsEvent o) => o -> m Event

Cast to Event, for types for which this is known to be safe. For general casts, use castTo.

Methods

Click to display all available methods, including inherited ones

Methods

ref, triggersContextMenu, unref.

Getters

getAxes, getAxis, getDevice, getDeviceTool, getDisplay, getEventSequence, getEventType, getHistory, getModifierState, getPointerEmulated, getPosition, getSeat, getSurface, getTime.

Setters

None.

getAxes

eventGetAxes

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event

-> m (Bool, [Double])

Returns: True on success, otherwise False

Extracts all axis values from an event.

getAxis

eventGetAxis

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event

-> AxisUse

axisUse: the axis use to look for

-> m (Bool, Double)

Returns: True if the specified axis was found, otherwise False

Extract the axis value for a particular axis use from an event structure.

getDevice

eventGetDevice

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event.

-> m (Maybe Device)

Returns: a Device.

Returns the device of an event.

getDeviceTool

eventGetDeviceTool

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event

-> m (Maybe DeviceTool)

Returns: The current device tool, or Nothing

If the event was generated by a device that supports different tools (eg. a tablet), this function will return a DeviceTool representing the tool that caused the event. Otherwise, Nothing will be returned.

Note: the GdkDeviceTools will be constant during the application lifetime, if settings must be stored persistently across runs, see deviceToolGetSerial

getDisplay

eventGetDisplay

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event

-> m (Maybe Display)

Returns: a Display

Retrieves the Display associated to the event.

getEventSequence

eventGetEventSequence

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event

-> m EventSequence

Returns: the event sequence that the event belongs to

If event is a touch event, returns the EventSequence to which the event belongs. Otherwise, return Nothing.

getEventType

eventGetEventType

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event

-> m EventType

Returns: a EventType

Retrieves the type of the event.

getHistory

eventGetHistory

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a motion or scroll Event

-> m (Maybe [TimeCoord])

Returns: an array of time and coordinates

Retrieves the history of the event, as a list of time and coordinates.

The history includes events that are not delivered to the application because they occurred in the same frame as event.

Note that only motion and scroll events record history, and motion events only if one of the mouse buttons is down.

getModifierState

eventGetModifierState

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event

-> m [ModifierType]

Returns: the modifier state of event

Returns the modifier state field of an event.

getPointerEmulated

eventGetPointerEmulated

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event

-> m Bool

Returns: True if this event is emulated

Returns whether this event is an 'emulated' pointer event (typically from a touch event), as opposed to a real one.

getPosition

eventGetPosition

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event

-> m (Bool, Double, Double)

Extract the event surface relative x/y coordinates from an event.

getSeat

eventGetSeat

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event

-> m (Maybe Seat)

Returns: a Seat.

Returns the seat that originated the event.

getSurface

eventGetSurface

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event

-> m Surface

Returns: The Surface associated with the event

Extracts the Surface associated with an event.

getTime

eventGetTime

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event

-> m Word32

Returns: time stamp field from event

Returns the time stamp from event, if there is one; otherwise returns CURRENT_TIME.

ref

eventRef

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event

-> m Event

Returns: event

Increase the ref count of event.

triggersContextMenu

eventTriggersContextMenu

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event, currently only button events are meaningful values

-> m Bool

Returns: True if the event should trigger a context menu.

This function returns whether a Event should trigger a context menu, according to platform conventions. The right mouse button always triggers context menus.

This function should always be used instead of simply checking for event->button == BUTTON_SECONDARY.

unref

eventUnref

Arguments

:: (HasCallStack, MonadIO m, IsEvent a)

=> a

event: a Event

-> m ()

Decrease the ref count of event, and free it if the last reference is dropped.