Gdk.Seat¶

Subclasses:	None

Methods¶

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

	`get_capabilities` ()
	`get_display` ()
	`get_keyboard` ()
	`get_pointer` ()
	`get_slaves` (capabilities)
	`grab` (window, capabilities, owner_events, cursor, event, prepare_func, *prepare_func_data)
	`ungrab` ()

Virtual Methods¶

Inherited:	GObject.Object (7)

Properties¶

Name	Type	Flags	Short Description
`display`	`Gdk.Display`	r/w/co	Display

Signals¶

Inherited:	GObject.Object (1)

Name	Short Description
`device-added`	The `::device-added` signal is emitted when a new input device is related to this seat.
`device-removed`	The `::device-removed` signal is emitted when an input device is removed (e.g.
`tool-added`	The `::tool-added` signal is emitted whenever a new tool is made known to the seat.
`tool-removed`	This signal is emitted whenever a tool is no longer known to this seat.

Fields¶

Inherited:	GObject.Object (1)

Name	Type	Access	Description
parent_instance	`GObject.Object`	r

Class Details¶

class Gdk.Seat(**kwargs)¶

Bases:	`GObject.Object`
Abstract:	Yes

The Gdk.Seat object represents a collection of input devices that belong to a user.

get_capabilities()[source]¶

Returns:	the seat capabilities
Return type:	`Gdk.SeatCapabilities`

Returns the capabilities this Gdk.Seat currently has.

New in version 3.20.

get_display()[source]¶

Returns:	a `Gdk.Display`. This object is owned by GTK+ and must not be freed.
Return type:	`Gdk.Display`

Returns the Gdk.Display this seat belongs to.

get_keyboard()[source]¶

Returns:	a master `Gdk.Device` with keyboard capabilities. This object is owned by GTK+ and must not be freed.
Return type:	`Gdk.Device` or `None`

Returns the master device that routes keyboard events.

New in version 3.20.

get_pointer()[source]¶

Returns:	a master `Gdk.Device` with pointer capabilities. This object is owned by GTK+ and must not be freed.
Return type:	`Gdk.Device` or `None`

Returns the master device that routes pointer events.

New in version 3.20.

get_slaves(capabilities)[source]¶

Parameters:	capabilities (`Gdk.SeatCapabilities`) – capabilities to get devices for
Returns:	A list of `Gdk.Devices`. The list must be freed with g_list_free(), the elements are owned by GDK and must not be freed.
Return type:	[`Gdk.Device`]

Returns the slave devices that match the given capabilities.

New in version 3.20.

grab(window, capabilities, owner_events, cursor, event, prepare_func, *prepare_func_data)[source]¶

Parameters:	window (`Gdk.Window`) – the `Gdk.Window` which will own the grab capabilities (`Gdk.SeatCapabilities`) – capabilities that will be grabbed owner_events (`bool`) – if `False` then all device events are reported with respect to window and are only reported if selected by event_mask. If `True` then pointer events for this application are reported as normal, but pointer events outside this application are reported with respect to window and only if selected by event_mask. In either mode, unreported events are discarded. cursor (`Gdk.Cursor` or `None`) – the cursor to display while the grab is active. If this is `None` then the normal cursors are used for window and its descendants, and the cursor for window is used elsewhere. event (`Gdk.Event` or `None`) – the event that is triggering the grab, or `None` if none is available. prepare_func (`Gdk.SeatGrabPrepareFunc` or `None`) – function to prepare the window to be grabbed, it can be `None` if window is visible before this call. prepare_func_data (`object` or `None`) – user data to pass to prepare_func
Returns:	`Gdk.GrabStatus.SUCCESS` if the grab was successful.
Return type:	`Gdk.GrabStatus`

Grabs the seat so that all events corresponding to the given capabilities are passed to this application until the seat is ungrabbed with Gdk.Seat.ungrab(), or the window becomes hidden. This overrides any previous grab on the seat by this client.

As a rule of thumb, if a grab is desired over Gdk.SeatCapabilities.POINTER, all other “pointing” capabilities (eg. Gdk.SeatCapabilities.TOUCH) should be grabbed too, so the user is able to interact with all of those while the grab holds, you should thus use Gdk.SeatCapabilities.ALL_POINTING most commonly.

Grabs are used for operations which need complete control over the events corresponding to the given capabilities. For example in GTK+ this is used for Drag and Drop operations, popup menus and such.

Note that if the event mask of a Gdk.Window has selected both button press and button release events, or touch begin and touch end, then a press event will cause an automatic grab until the button is released, equivalent to a grab on the window with owner_events set to True. This is done because most applications expect to receive paired press and release events.

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 Gdk.EventGrabBroken events that are emitted when the grab ends unvoluntarily.

New in version 3.20.

ungrab()[source]¶: Releases a grab added through Gdk.Seat.grab().

New in version 3.20.

Signal Details¶

Gdk.Seat.signals.device_added(seat, device)¶

Signal Name:	`device-added`
Flags:	`RUN_LAST`
Parameters:	seat (`Gdk.Seat`) – The object which received the signal device (`Gdk.Device`) – the newly added `Gdk.Device`.

The ::device-added signal is emitted when a new input device is related to this seat.

New in version 3.20.

Gdk.Seat.signals.device_removed(seat, device)¶

Signal Name:	`device-removed`
Flags:	`RUN_LAST`
Parameters:	seat (`Gdk.Seat`) – The object which received the signal device (`Gdk.Device`) – the just removed `Gdk.Device`.

The ::device-removed signal is emitted when an input device is removed (e.g. unplugged).

New in version 3.20.

Gdk.Seat.signals.tool_added(seat, tool)¶

Signal Name:	`tool-added`
Flags:	`RUN_LAST`
Parameters:	seat (`Gdk.Seat`) – The object which received the signal tool (`Gdk.DeviceTool`) – the new `Gdk.DeviceTool` known to the seat

The ::tool-added signal is emitted whenever a new tool is made known to the seat. The tool may later be assigned to a device (i.e. on proximity with a tablet). The device will emit the Gdk.Device ::tool-changed signal accordingly.

A same tool may be used by several devices.

New in version 3.22.

Gdk.Seat.signals.tool_removed(seat, tool)¶

Signal Name:	`tool-removed`
Flags:	`RUN_LAST`
Parameters:	seat (`Gdk.Seat`) – The object which received the signal tool (`Gdk.DeviceTool`) – the just removed `Gdk.DeviceTool`

This signal is emitted whenever a tool is no longer known to this seat.

New in version 3.22.

Property Details¶

Gdk.Seat.props.display¶

Name:	`display`
Type:	`Gdk.Display`
Default Value:	`None`
Flags:	`READABLE`, `WRITABLE`, `CONSTRUCT_ONLY`

Gdk.Display of this seat.

New in version 3.20.