DeviceToolProtocol
public protocol DeviceToolProtocol : ObjectProtocol
The DeviceToolProtocol
protocol exposes the methods and properties of an underlying GdkDeviceTool
instance.
The default implementation of these can be found in the protocol extension below.
For a concrete class that implements these methods and properties, see DeviceTool
.
Alternatively, use DeviceToolRef
as a lighweight, unowned
reference if you already have an instance you just want to use.
A physical tool associated to a GdkDevice
.
-
Untyped pointer to the underlying
GdkDeviceTool
instance.Declaration
Swift
var ptr: UnsafeMutableRawPointer! { get }
-
device_tool_ptr
Default implementationTyped pointer to the underlying
GdkDeviceTool
instance.Default Implementation
Return the stored, untyped pointer as a typed pointer to the
GdkDeviceTool
instance.Declaration
Swift
var device_tool_ptr: UnsafeMutablePointer<GdkDeviceTool>! { get }
-
Required Initialiser for types conforming to
DeviceToolProtocol
Declaration
Swift
init(raw: UnsafeMutableRawPointer)
-
bind(property:
Extension methodto: _: flags: transformFrom: transformTo: ) Bind a
DeviceToolPropertyName
source property to a given target object.Declaration
Swift
@discardableResult @inlinable func bind<Q, T>(property source_property: DeviceToolPropertyName, to target: T, _ target_property: Q, flags f: BindingFlags = .default, transformFrom transform_from: @escaping GLibObject.ValueTransformer = { $0.transform(destValue: $1) }, transformTo transform_to: @escaping GLibObject.ValueTransformer = { $0.transform(destValue: $1) }) -> BindingRef! where Q : PropertyNameProtocol, T : ObjectProtocol
Parameters
source_property
the source property to bind
target
the target object to bind to
target_property
the target property to bind to
flags
the flags to pass to the
Binding
transform_from
ValueTransformer
to use for forward transformationtransform_to
ValueTransformer
to use for backwards transformationReturn Value
binding reference or
nil
in case of an error -
get(property:
Extension method) Get the value of a DeviceTool property
Declaration
Swift
@inlinable func get(property: DeviceToolPropertyName) -> GLibObject.Value
Parameters
property
the property to get the value for
Return Value
the value of the named property
-
set(property:
Extension methodvalue: ) Set the value of a DeviceTool property. Note that this will only have an effect on properties that are writable and not construct-only!
Declaration
Swift
@inlinable func set(property: DeviceToolPropertyName, value v: GLibObject.Value)
Parameters
property
the property to get the value for
Return Value
the value of the named property
-
getAxes()
Extension methodGets the axes of the tool.
Declaration
Swift
@inlinable func getAxes() -> AxisFlags
-
getHardwareId()
Extension methodGets 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
hardware_id
, but will have different serial numbers (see [methodGdk.DeviceTool.get_serial
]).This is a more concrete (and device specific) method to identify a
GdkDeviceTool
than [methodGdk.DeviceTool.get_tool_type
], as a tablet may support multiple devices with the sameGdkDeviceToolType
, but different hardware identificators.Declaration
Swift
@inlinable func getHardwareId() -> guint64
-
getSerial()
Extension methodGets the serial number of this tool.
This value can be used to identify a physical tool (eg. a tablet pen) across program executions.
Declaration
Swift
@inlinable func getSerial() -> guint64
-
getToolType()
Extension methodGets the
GdkDeviceToolType
of the tool.Declaration
Swift
@inlinable func getToolType() -> GdkDeviceToolType
-
axes
Extension methodThe axes of the tool.
Declaration
Swift
@inlinable var axes: AxisFlags { get }
-
hardwareId
Extension methodGets 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
hardware_id
, but will have different serial numbers (see [methodGdk.DeviceTool.get_serial
]).This is a more concrete (and device specific) method to identify a
GdkDeviceTool
than [methodGdk.DeviceTool.get_tool_type
], as a tablet may support multiple devices with the sameGdkDeviceToolType
, but different hardware identificators.Declaration
Swift
@inlinable var hardwareId: guint64 { get }
-
serial
Extension methodThe serial number of the tool.
Declaration
Swift
@inlinable var serial: guint64 { get }
-
toolType
Extension methodGets the
GdkDeviceToolType
of the tool.Declaration
Swift
@inlinable var toolType: GdkDeviceToolType { get }