gi-gdk-4.0.4: Gdk bindings
CopyrightWill Thompson and Iñaki García Etxebarria
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria
Safe HaskellSafe-Inferred
LanguageHaskell2010

GI.Gdk.Objects.DeviceTool

Description

A physical tool associated to a GdkDevice.

Synopsis

Exported types

newtype DeviceTool Source #

Memory-managed wrapper type.

class (GObject o, IsDescendantOf DeviceTool o) => IsDeviceTool o Source #

Type class for types which can be safely cast to DeviceTool, for instance with toDeviceTool.

Instances

Instances details
(GObject o, IsDescendantOf DeviceTool o) => IsDeviceTool o Source # 
Instance details

Defined in GI.Gdk.Objects.DeviceTool

toDeviceTool :: (MonadIO m, IsDeviceTool o) => o -> m DeviceTool Source #

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

Methods

getAxes

deviceToolGetAxes Source #

Arguments

:: (HasCallStack, MonadIO m, IsDeviceTool a) 
=> a

tool: a GdkDeviceTool

-> m [AxisFlags]

Returns: the axes of tool

Gets the axes of the tool.

getHardwareId

deviceToolGetHardwareId Source #

Arguments

:: (HasCallStack, MonadIO m, IsDeviceTool a) 
=> a

tool: a GdkDeviceTool

-> m Word64

Returns: The hardware identificator of this tool.

Gets the hardware ID of this tool, or 0 if it's not known.

When non-zero, the identificator is unique for the given tool model, meaning that two identical tools will share the same hardwareId, but will have different serial numbers (see deviceToolGetSerial).

This is a more concrete (and device specific) method to identify a GdkDeviceTool than deviceToolGetToolType, as a tablet may support multiple devices with the same GdkDeviceToolType, but different hardware identificators.

getSerial

deviceToolGetSerial Source #

Arguments

:: (HasCallStack, MonadIO m, IsDeviceTool a) 
=> a

tool: a GdkDeviceTool

-> m Word64

Returns: The serial ID for this tool

Gets the serial number of this tool.

This value can be used to identify a physical tool (eg. a tablet pen) across program executions.

getToolType

deviceToolGetToolType Source #

Arguments

:: (HasCallStack, MonadIO m, IsDeviceTool a) 
=> a

tool: a GdkDeviceTool

-> m DeviceToolType

Returns: The physical type for this tool. This can be used to figure out what sort of pen is being used, such as an airbrush or a pencil.

Gets the GdkDeviceToolType of the tool.

Properties

axes

The axes of the tool.

constructDeviceToolAxes :: (IsDeviceTool o, MonadIO m) => [AxisFlags] -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “axes” property. This is rarely needed directly, but it is used by new.

getDeviceToolAxes :: (MonadIO m, IsDeviceTool o) => o -> m [AxisFlags] Source #

Get the value of the “axes” property. When overloading is enabled, this is equivalent to

get deviceTool #axes

hardwareId

The hardware ID of the tool.

constructDeviceToolHardwareId :: (IsDeviceTool o, MonadIO m) => Word64 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “hardware-id” property. This is rarely needed directly, but it is used by new.

getDeviceToolHardwareId :: (MonadIO m, IsDeviceTool o) => o -> m Word64 Source #

Get the value of the “hardware-id” property. When overloading is enabled, this is equivalent to

get deviceTool #hardwareId

serial

The serial number of the tool.

constructDeviceToolSerial :: (IsDeviceTool o, MonadIO m) => Word64 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “serial” property. This is rarely needed directly, but it is used by new.

getDeviceToolSerial :: (MonadIO m, IsDeviceTool o) => o -> m Word64 Source #

Get the value of the “serial” property. When overloading is enabled, this is equivalent to

get deviceTool #serial

toolType

The type of the tool.

constructDeviceToolToolType :: (IsDeviceTool o, MonadIO m) => DeviceToolType -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “tool-type” property. This is rarely needed directly, but it is used by new.

getDeviceToolToolType :: (MonadIO m, IsDeviceTool o) => o -> m DeviceToolType Source #

Get the value of the “tool-type” property. When overloading is enabled, this is equivalent to

get deviceTool #toolType