Gdk.DeviceTool¶

Subclasses:	None

Methods¶

Inherited:	GObject.Object (37)
Structs:	GObject.ObjectClass (5)

	`get_hardware_id` ()
	`get_serial` ()
	`get_tool_type` ()

Virtual Methods¶

Inherited:	GObject.Object (7)

Properties¶

Name	Type	Flags	Short Description
`axes`	`Gdk.AxisFlags`	r/w/co	Tool axes
`hardware-id`	`int`	r/w/co	Hardware ID
`serial`	`int`	r/w/co	Serial number
`tool-type`	`Gdk.DeviceToolType`	r/w/co	Tool type

Signals¶

Inherited:	GObject.Object (1)

Fields¶

Inherited:	GObject.Object (1)

Class Details¶

class Gdk.DeviceTool(**kwargs)¶

Bases:	`GObject.Object`
Abstract:	No

get_hardware_id()[source]¶

Returns:	The hardware identificator of this tool.
Return type:	`int`

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 hardware_id, but will have different serial numbers (see Gdk.DeviceTool.get_serial()).

This is a more concrete (and device specific) method to identify a Gdk.DeviceTool than Gdk.DeviceTool.get_tool_type(), as a tablet may support multiple devices with the same Gdk.DeviceToolType, but having different hardware identificators.

New in version 3.22.

get_serial()[source]¶

Returns:	The serial ID for this tool
Return type:	`int`

Gets the serial of this tool, this value can be used to identify a physical tool (eg. a tablet pen) across program executions.

New in version 3.22.

get_tool_type()[source]¶

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.
Return type:	`Gdk.DeviceToolType`

Gets the Gdk.DeviceToolType of the tool.

New in version 3.22.

Property Details¶

Gdk.DeviceTool.props.axes¶

Name:	`axes`
Type:	`Gdk.AxisFlags`
Default Value:	`0`
Flags:	`READABLE`, `WRITABLE`, `CONSTRUCT_ONLY`

Tool axes

Gdk.DeviceTool.props.hardware_id¶

Name:	`hardware-id`
Type:	`int`
Default Value:	`0`
Flags:	`READABLE`, `WRITABLE`, `CONSTRUCT_ONLY`

Hardware ID

Gdk.DeviceTool.props.serial¶

Name:	`serial`
Type:	`int`
Default Value:	`0`
Flags:	`READABLE`, `WRITABLE`, `CONSTRUCT_ONLY`

Serial number

Gdk.DeviceTool.props.tool_type¶

Name:	`tool-type`
Type:	`Gdk.DeviceToolType`
Default Value:	`Gdk.DeviceToolType.UNKNOWN`
Flags:	`READABLE`, `WRITABLE`, `CONSTRUCT_ONLY`

Tool type