Copyright | Will Thompson Iñaki García Etxebarria and Jonas Platte |
---|---|
License | LGPL-2.1 |
Maintainer | Iñaki García Etxebarria (garetxe@gmail.com) |
Safe Haskell | None |
Language | Haskell2010 |
- Exported types
- Methods
- getAssociatedDevice
- getAxes
- getAxisUse
- getDeviceType
- getDisplay
- getHasCursor
- getKey
- getLastEventWindow
- getMode
- getNAxes
- getNKeys
- getName
- getPosition
- getPositionDouble
- getProductId
- getSeat
- getSource
- getVendorId
- getWindowAtPosition
- getWindowAtPositionDouble
- grab
- grabInfoLibgtkOnly
- listAxes
- listSlaveDevices
- setAxisUse
- setKey
- setMode
- ungrab
- warp
- Properties
- Signals
The Device
object represents a single input device, such
as a keyboard, a mouse, a touchpad, etc.
See the DeviceManager
documentation for more information
about the various kinds of master and slave devices, and their
relationships.
- newtype Device = Device (ManagedPtr Device)
- class GObject o => IsDevice o
- toDevice :: (MonadIO m, IsDevice o) => o -> m Device
- noDevice :: Maybe Device
- deviceGetAssociatedDevice :: (HasCallStack, MonadIO m, IsDevice a) => a -> m (Maybe Device)
- deviceGetAxes :: (HasCallStack, MonadIO m, IsDevice a) => a -> m [AxisFlags]
- deviceGetAxisUse :: (HasCallStack, MonadIO m, IsDevice a) => a -> Word32 -> m AxisUse
- deviceGetDeviceType :: (HasCallStack, MonadIO m, IsDevice a) => a -> m DeviceType
- deviceGetDisplay :: (HasCallStack, MonadIO m, IsDevice a) => a -> m Display
- deviceGetHasCursor :: (HasCallStack, MonadIO m, IsDevice a) => a -> m Bool
- deviceGetKey :: (HasCallStack, MonadIO m, IsDevice a) => a -> Word32 -> m (Bool, Word32, [ModifierType])
- deviceGetLastEventWindow :: (HasCallStack, MonadIO m, IsDevice a) => a -> m (Maybe Window)
- deviceGetMode :: (HasCallStack, MonadIO m, IsDevice a) => a -> m InputMode
- deviceGetNAxes :: (HasCallStack, MonadIO m, IsDevice a) => a -> m Int32
- deviceGetNKeys :: (HasCallStack, MonadIO m, IsDevice a) => a -> m Int32
- deviceGetName :: (HasCallStack, MonadIO m, IsDevice a) => a -> m Text
- deviceGetPosition :: (HasCallStack, MonadIO m, IsDevice a) => a -> m (Screen, Int32, Int32)
- deviceGetPositionDouble :: (HasCallStack, MonadIO m, IsDevice a) => a -> m (Screen, Double, Double)
- deviceGetProductId :: (HasCallStack, MonadIO m, IsDevice a) => a -> m (Maybe Text)
- deviceGetSeat :: (HasCallStack, MonadIO m, IsDevice a) => a -> m Seat
- deviceGetSource :: (HasCallStack, MonadIO m, IsDevice a) => a -> m InputSource
- deviceGetVendorId :: (HasCallStack, MonadIO m, IsDevice a) => a -> m (Maybe Text)
- deviceGetWindowAtPosition :: (HasCallStack, MonadIO m, IsDevice a) => a -> m (Maybe Window, Int32, Int32)
- deviceGetWindowAtPositionDouble :: (HasCallStack, MonadIO m, IsDevice a) => a -> m (Maybe Window, Double, Double)
- deviceGrab :: (HasCallStack, MonadIO m, IsDevice a, IsWindow b, IsCursor c) => a -> b -> GrabOwnership -> Bool -> [EventMask] -> Maybe c -> Word32 -> m GrabStatus
- deviceGrabInfoLibgtkOnly :: (HasCallStack, MonadIO m, IsDisplay a, IsDevice b) => a -> b -> m (Bool, Window, Bool)
- deviceListAxes :: (HasCallStack, MonadIO m, IsDevice a) => a -> m [Atom]
- deviceListSlaveDevices :: (HasCallStack, MonadIO m, IsDevice a) => a -> m [Device]
- deviceSetAxisUse :: (HasCallStack, MonadIO m, IsDevice a) => a -> Word32 -> AxisUse -> m ()
- deviceSetKey :: (HasCallStack, MonadIO m, IsDevice a) => a -> Word32 -> Word32 -> [ModifierType] -> m ()
- deviceSetMode :: (HasCallStack, MonadIO m, IsDevice a) => a -> InputMode -> m Bool
- deviceUngrab :: (HasCallStack, MonadIO m, IsDevice a) => a -> Word32 -> m ()
- deviceWarp :: (HasCallStack, MonadIO m, IsDevice a, IsScreen b) => a -> b -> Int32 -> Int32 -> m ()
- getDeviceAssociatedDevice :: (MonadIO m, IsDevice o) => o -> m (Maybe Device)
- getDeviceAxes :: (MonadIO m, IsDevice o) => o -> m [AxisFlags]
- constructDeviceDeviceManager :: (IsDevice o, IsDeviceManager a) => a -> IO (GValueConstruct o)
- getDeviceDeviceManager :: (MonadIO m, IsDevice o) => o -> m (Maybe DeviceManager)
- constructDeviceDisplay :: (IsDevice o, IsDisplay a) => a -> IO (GValueConstruct o)
- getDeviceDisplay :: (MonadIO m, IsDevice o) => o -> m Display
- constructDeviceHasCursor :: IsDevice o => Bool -> IO (GValueConstruct o)
- getDeviceHasCursor :: (MonadIO m, IsDevice o) => o -> m Bool
- constructDeviceInputMode :: IsDevice o => InputMode -> IO (GValueConstruct o)
- getDeviceInputMode :: (MonadIO m, IsDevice o) => o -> m InputMode
- setDeviceInputMode :: (MonadIO m, IsDevice o) => o -> InputMode -> m ()
- constructDeviceInputSource :: IsDevice o => InputSource -> IO (GValueConstruct o)
- getDeviceInputSource :: (MonadIO m, IsDevice o) => o -> m InputSource
- getDeviceNAxes :: (MonadIO m, IsDevice o) => o -> m Word32
- constructDeviceName :: IsDevice o => Text -> IO (GValueConstruct o)
- getDeviceName :: (MonadIO m, IsDevice o) => o -> m Text
- constructDeviceNumTouches :: IsDevice o => Word32 -> IO (GValueConstruct o)
- getDeviceNumTouches :: (MonadIO m, IsDevice o) => o -> m Word32
- constructDeviceProductId :: IsDevice o => Text -> IO (GValueConstruct o)
- getDeviceProductId :: (MonadIO m, IsDevice o) => o -> m (Maybe Text)
- clearDeviceSeat :: (MonadIO m, IsDevice o) => o -> m ()
- constructDeviceSeat :: (IsDevice o, IsSeat a) => a -> IO (GValueConstruct o)
- getDeviceSeat :: (MonadIO m, IsDevice o) => o -> m Seat
- setDeviceSeat :: (MonadIO m, IsDevice o, IsSeat a) => o -> a -> m ()
- getDeviceTool :: (MonadIO m, IsDevice o) => o -> m (Maybe DeviceTool)
- constructDeviceType :: IsDevice o => DeviceType -> IO (GValueConstruct o)
- getDeviceType :: (MonadIO m, IsDevice o) => o -> m DeviceType
- constructDeviceVendorId :: IsDevice o => Text -> IO (GValueConstruct o)
- getDeviceVendorId :: (MonadIO m, IsDevice o) => o -> m (Maybe Text)
- type C_DeviceChangedCallback = Ptr () -> Ptr () -> IO ()
- type DeviceChangedCallback = IO ()
- afterDeviceChanged :: (IsDevice a, MonadIO m) => a -> DeviceChangedCallback -> m SignalHandlerId
- genClosure_DeviceChanged :: DeviceChangedCallback -> IO Closure
- mk_DeviceChangedCallback :: C_DeviceChangedCallback -> IO (FunPtr C_DeviceChangedCallback)
- noDeviceChangedCallback :: Maybe DeviceChangedCallback
- onDeviceChanged :: (IsDevice a, MonadIO m) => a -> DeviceChangedCallback -> m SignalHandlerId
- wrap_DeviceChangedCallback :: DeviceChangedCallback -> Ptr () -> Ptr () -> IO ()
- type C_DeviceToolChangedCallback = Ptr () -> Ptr DeviceTool -> Ptr () -> IO ()
- type DeviceToolChangedCallback = DeviceTool -> IO ()
- afterDeviceToolChanged :: (IsDevice a, MonadIO m) => a -> DeviceToolChangedCallback -> m SignalHandlerId
- genClosure_DeviceToolChanged :: DeviceToolChangedCallback -> IO Closure
- mk_DeviceToolChangedCallback :: C_DeviceToolChangedCallback -> IO (FunPtr C_DeviceToolChangedCallback)
- noDeviceToolChangedCallback :: Maybe DeviceToolChangedCallback
- onDeviceToolChanged :: (IsDevice a, MonadIO m) => a -> DeviceToolChangedCallback -> m SignalHandlerId
- wrap_DeviceToolChangedCallback :: DeviceToolChangedCallback -> Ptr () -> Ptr DeviceTool -> Ptr () -> IO ()
Exported types
Methods
getAssociatedDevice
deviceGetAssociatedDevice Source #
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m (Maybe Device) | Returns: The associated device, or
|
Returns the associated device to device
, if device
is of type
DeviceTypeMaster
, it will return the paired pointer or
keyboard.
If device
is of type DeviceTypeSlave
, it will return
the master device to which device
is attached to.
If device
is of type DeviceTypeFloating
, Nothing
will be
returned, as there is no associated device.
Since: 3.0
getAxes
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m [AxisFlags] |
Returns the axes currently available on the device.
Since: 3.22
getAxisUse
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> Word32 |
|
-> m AxisUse | Returns: a |
Returns the axis use for index_
.
Since: 2.20
getDeviceType
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m DeviceType | Returns: the |
Returns the device type for device
.
Since: 3.0
getDisplay
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m Display | Returns: a |
Returns the Display
to which device
pertains.
Since: 3.0
getHasCursor
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m Bool | Returns: |
Determines whether the pointer follows device motion. This is not meaningful for keyboard devices, which don't have a pointer.
Since: 2.20
getKey
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> Word32 |
|
-> m (Bool, Word32, [ModifierType]) | Returns: |
If index_
has a valid keyval, this function will return True
and fill in keyval
and modifiers
with the keyval settings.
Since: 2.20
getLastEventWindow
deviceGetLastEventWindow Source #
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m (Maybe Window) | Returns: the last window the device |
Gets information about which window the given pointer device is in, based on events
that have been received so far from the display server. If another application
has a pointer grab, or this application has a grab with owner_events = False
,
Nothing
may be returned even if the pointer is physically over one of this
application's windows.
Since: 3.12
getMode
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m InputMode | Returns: a |
Determines the mode of the device.
Since: 2.20
getNAxes
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m Int32 | Returns: the number of axes. |
Returns the number of axes the device currently has.
Since: 3.0
getNKeys
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m Int32 | Returns: the number of keys. |
Returns the number of keys the device currently has.
Since: 2.24
getName
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m Text | Returns: a name |
Determines the name of the device.
Since: 2.20
getPosition
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m (Screen, Int32, Int32) |
Gets the current location of device
. As a slave device
coordinates are those of its master pointer, This function
may not be called on devices of type DeviceTypeSlave
,
unless there is an ongoing grab on them, see deviceGrab
.
Since: 3.0
getPositionDouble
deviceGetPositionDouble Source #
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m (Screen, Double, Double) |
Gets the current location of device
in double precision. As a slave device's
coordinates are those of its master pointer, this function
may not be called on devices of type DeviceTypeSlave
,
unless there is an ongoing grab on them. See deviceGrab
.
Since: 3.10
getProductId
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m (Maybe Text) | Returns: the product ID, or |
Returns the product ID of this device, or Nothing
if this information couldn't
be obtained. This ID is retrieved from the device, and is thus constant for
it. See deviceGetVendorId
for more information.
Since: 3.16
getSeat
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m Seat | Returns: A |
Returns the Seat
the device belongs to.
Since: 3.20
getSource
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m InputSource | Returns: a |
Determines the type of the device.
Since: 2.20
getVendorId
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m (Maybe Text) | Returns: the vendor ID, or |
Returns the vendor ID of this device, or Nothing
if this information couldn't
be obtained. This ID is retrieved from the device, and is thus constant for
it.
This function, together with deviceGetProductId
, can be used to eg.
compose Settings
paths to store settings for this device.
C code
static GSettings * get_device_settings (GdkDevice *device) { const gchar *vendor, *product; GSettings *settings; GdkDevice *device; gchar *path; vendor = gdk_device_get_vendor_id (device); product = gdk_device_get_product_id (device); path = g_strdup_printf ("/org/example/app/devices/%s:%s/", vendor, product); settings = g_settings_new_with_path (DEVICE_SCHEMA, path); g_free (path); return settings; }
Since: 3.16
getWindowAtPosition
deviceGetWindowAtPosition Source #
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m (Maybe Window, Int32, Int32) |
Obtains the window underneath device
, returning the location of the device in winX
and winY
. Returns
Nothing
if the window tree under device
is not known to GDK (for example, belongs to another application).
As a slave device coordinates are those of its master pointer, This
function may not be called on devices of type DeviceTypeSlave
,
unless there is an ongoing grab on them, see deviceGrab
.
Since: 3.0
getWindowAtPositionDouble
deviceGetWindowAtPositionDouble Source #
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m (Maybe Window, Double, Double) |
Obtains the window underneath device
, returning the location of the device in winX
and winY
in
double precision. Returns Nothing
if the window tree under device
is not known to GDK (for example,
belongs to another application).
As a slave device coordinates are those of its master pointer, This
function may not be called on devices of type DeviceTypeSlave
,
unless there is an ongoing grab on them, see deviceGrab
.
Since: 3.0
grab
:: (HasCallStack, MonadIO m, IsDevice a, IsWindow b, IsCursor c) | |
=> a |
|
-> b |
|
-> GrabOwnership |
|
-> Bool |
|
-> [EventMask] |
|
-> Maybe c |
|
-> Word32 |
|
-> m GrabStatus | Returns: |
Deprecated: (Since version 3.20.)Use seatGrab
instead.
Grabs the device so that all events coming from this device are passed to
this application until the device is ungrabbed with deviceUngrab
,
or the window becomes unviewable. This overrides any previous grab on the device
by this client.
Note that device
and window
need to be on the same display.
Device grabs are used for operations which need complete control over the given device events (either pointer or keyboard). For example in GTK+ this is used for Drag and Drop operations, popup menus and such.
Note that if the event mask of an X window has selected both button press
and button release events, then a button press event will cause an automatic
pointer grab until the button is released. X does this automatically since
most applications expect to receive button press and release events in pairs.
It is equivalent to a pointer grab on the window with ownerEvents
set to
True
.
If you set up anything at the time you take the grab that needs to be
cleaned up when the grab ends, you should handle the EventGrabBroken
events that are emitted when the grab ends unvoluntarily.
Since: 3.0
grabInfoLibgtkOnly
deviceGrabInfoLibgtkOnly Source #
:: (HasCallStack, MonadIO m, IsDisplay a, IsDevice b) | |
=> a |
|
-> b |
|
-> m (Bool, Window, Bool) | Returns: |
Deprecated: (Since version 3.16)The symbol was never meant to be used outside of GTK+
Determines information about the current keyboard grab. This is not public API and must not be used by applications.
listAxes
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m [Atom] | Returns:
A |
Returns a List
of GdkAtoms
, containing the labels for
the axes that device
currently has.
Since: 3.0
listSlaveDevices
deviceListSlaveDevices Source #
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> m [Device] | Returns:
the list of slave devices, or |
If the device if of type DeviceTypeMaster
, it will return
the list of slave devices attached to it, otherwise it will return
Nothing
setAxisUse
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> Word32 |
|
-> AxisUse |
|
-> m () |
Specifies how an axis of a device is used.
setKey
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> Word32 |
|
-> Word32 |
|
-> [ModifierType] |
|
-> m () |
Specifies the X key event to generate when a macro button of a device is pressed.
setMode
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> InputMode |
|
-> m Bool | Returns: |
Sets a the mode of an input device. The mode controls if the device is active and whether the device’s range is mapped to the entire screen or to a single window.
Note: This is only meaningful for floating devices, master devices (and slaves connected to these) drive the pointer cursor, which is not limited by the input mode.
ungrab
:: (HasCallStack, MonadIO m, IsDevice a) | |
=> a |
|
-> Word32 |
|
-> m () |
warp
:: (HasCallStack, MonadIO m, IsDevice a, IsScreen b) | |
=> a |
|
-> b |
|
-> Int32 |
|
-> Int32 |
|
-> m () |
Warps device
in display
to the point x
,y
on
the screen screen
, unless the device is confined
to a window by a grab, in which case it will be moved
as far as allowed by the grab. Warping the pointer
creates events as if the user had moved the mouse
instantaneously to the destination.
Note that the pointer should normally be under the
control of the user. This function was added to cover
some rare use cases like keyboard navigation support
for the color picker in the GtkColorSelectionDialog
.
Since: 3.0
Properties
associatedDevice
axes
deviceManager
constructDeviceDeviceManager :: (IsDevice o, IsDeviceManager a) => a -> IO (GValueConstruct o) Source #
getDeviceDeviceManager :: (MonadIO m, IsDevice o) => o -> m (Maybe DeviceManager) Source #
display
constructDeviceDisplay :: (IsDevice o, IsDisplay a) => a -> IO (GValueConstruct o) Source #
hasCursor
constructDeviceHasCursor :: IsDevice o => Bool -> IO (GValueConstruct o) Source #
inputMode
constructDeviceInputMode :: IsDevice o => InputMode -> IO (GValueConstruct o) Source #
inputSource
constructDeviceInputSource :: IsDevice o => InputSource -> IO (GValueConstruct o) Source #
getDeviceInputSource :: (MonadIO m, IsDevice o) => o -> m InputSource Source #
nAxes
name
constructDeviceName :: IsDevice o => Text -> IO (GValueConstruct o) Source #
numTouches
constructDeviceNumTouches :: IsDevice o => Word32 -> IO (GValueConstruct o) Source #
productId
constructDeviceProductId :: IsDevice o => Text -> IO (GValueConstruct o) Source #
seat
clearDeviceSeat :: (MonadIO m, IsDevice o) => o -> m () Source #
constructDeviceSeat :: (IsDevice o, IsSeat a) => a -> IO (GValueConstruct o) Source #
tool
getDeviceTool :: (MonadIO m, IsDevice o) => o -> m (Maybe DeviceTool) Source #
type
constructDeviceType :: IsDevice o => DeviceType -> IO (GValueConstruct o) Source #
getDeviceType :: (MonadIO m, IsDevice o) => o -> m DeviceType Source #
vendorId
constructDeviceVendorId :: IsDevice o => Text -> IO (GValueConstruct o) Source #
Signals
changed
type DeviceChangedCallback = IO () Source #
afterDeviceChanged :: (IsDevice a, MonadIO m) => a -> DeviceChangedCallback -> m SignalHandlerId Source #
onDeviceChanged :: (IsDevice a, MonadIO m) => a -> DeviceChangedCallback -> m SignalHandlerId Source #
wrap_DeviceChangedCallback :: DeviceChangedCallback -> Ptr () -> Ptr () -> IO () Source #
toolChanged
type C_DeviceToolChangedCallback = Ptr () -> Ptr DeviceTool -> Ptr () -> IO () Source #
type DeviceToolChangedCallback = DeviceTool -> IO () Source #
afterDeviceToolChanged :: (IsDevice a, MonadIO m) => a -> DeviceToolChangedCallback -> m SignalHandlerId Source #
mk_DeviceToolChangedCallback :: C_DeviceToolChangedCallback -> IO (FunPtr C_DeviceToolChangedCallback) Source #
onDeviceToolChanged :: (IsDevice a, MonadIO m) => a -> DeviceToolChangedCallback -> m SignalHandlerId Source #
wrap_DeviceToolChangedCallback :: DeviceToolChangedCallback -> Ptr () -> Ptr DeviceTool -> Ptr () -> IO () Source #