Gdk.Seat - Classes - Gdk 3.0 (original) (raw)
g GObject.Object GObject.Object Gdk.Seat Gdk.Seat GObject.Object->Gdk.Seat
Subclasses:
None
Methods¶
Inherited:
Structs:
| 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:
Properties¶
| Name | Type | Flags | Short Description |
|---|---|---|---|
| display | Gdk.Display | r/w/co | Display |
Signals¶
Inherited:
| 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:
| Name | Type | Access | Description |
|---|---|---|---|
| parent_instance | GObject.Object | r |
Class Details¶
class Gdk.Seat(**kwargs)¶
Bases:
Abstract:
Yes
The Gdk.Seat object represents a collection of input devices that belong to a user.
Returns:
the seat capabilities
Return type:
Returns the capabilities this Gdk.Seat currently has.
New in version 3.20.
Returns:
a Gdk.Display. This object is owned by GTK+ and must not be freed.
Return type:
Returns the Gdk.Display this seat belongs to.
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.
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:
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 towindow and are only reported if selected by event_mask. IfTrue 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 byevent_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 forwindow 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:
Grabs the seat so that all events corresponding to the given capabilitiesare 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.EventGrabBrokenevents that are emitted when the grab ends unvoluntarily.
New in version 3.20.
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:
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:
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:
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:
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:
Default Value:
Flags:
READABLE, WRITABLE, CONSTRUCT_ONLY
Gdk.Display of this seat.
New in version 3.20.