GdkSeatGrabPrepareFunc ()

void
(*GdkSeatGrabPrepareFunc) (GdkSeat *seat,
                           GdkWindow *window,
                           gpointer user_data);

Type of the callback used to set up window so it can be grabbed. A typical action would be ensuring the window is visible, although there's room for other initialization actions.

Since: 3.20

gdk_seat_get_display ()

GdkDisplay *
gdk_seat_get_display (GdkSeat *seat);

Returns the GdkDisplay this seat belongs to.

gdk_seat_grab ()

GdkGrabStatus
gdk_seat_grab (GdkSeat *seat,
               GdkWindow *window,
               GdkSeatCapabilities capabilities,
               gboolean owner_events,
               GdkCursor *cursor,
               const GdkEvent *event,
               GdkSeatGrabPrepareFunc prepare_func,
               gpointer prepare_func_data);

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_SEAT_CAPABILITY_POINTER, all other "pointing" capabilities (eg. GDK_SEAT_CAPABILITY_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_SEAT_CAPABILITY_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 GdkWindow 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 GdkEventGrabBroken events that are emitted when the grab ends unvoluntarily.

Since: 3.20

gdk_seat_ungrab ()

void
gdk_seat_ungrab (GdkSeat *seat);

Releases a grab added through gdk_seat_grab().

Since: 3.20

gdk_seat_get_capabilities ()

GdkSeatCapabilities
gdk_seat_get_capabilities (GdkSeat *seat);

Returns the capabilities this GdkSeat currently has.

Since: 3.20

gdk_seat_get_pointer ()

GdkDevice *
gdk_seat_get_pointer (GdkSeat *seat);

Returns the master device that routes pointer events.

Since: 3.20

gdk_seat_get_keyboard ()

GdkDevice *
gdk_seat_get_keyboard (GdkSeat *seat);

Returns the master device that routes keyboard events.

Since: 3.20

gdk_seat_get_slaves ()

GList *
gdk_seat_get_slaves (GdkSeat *seat,
                     GdkSeatCapabilities capabilities);

Returns the slave devices that match the given capabilities.

Since: 3.20

GdkSeat

typedef struct _GdkSeat GdkSeat;

enum GdkSeatCapabilities

Flags describing the seat capabilities.

Since: 3.20

The “display” property

  “display”                  GdkDisplay *

GdkDisplay of this seat.

Owner: GdkSeat

Flags: Read / Write / Construct Only

Since: 3.20

The “device-added” signal

void
user_function (GdkSeat   *seat,
               GdkDevice *device,
               gpointer   user_data)

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

Flags: Run Last

Since: 3.20

The “device-removed” signal

void
user_function (GdkSeat   *seat,
               GdkDevice *device,
               gpointer   user_data)

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

Flags: Run Last

Since: 3.20

The “tool-added” signal

void
user_function (GdkSeat       *seat,
               GdkDeviceTool *tool,
               gpointer       user_data)

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 “tool-changed” signal accordingly.

A same tool may be used by several devices.

Flags: Run Last

Since: 3.22

The “tool-removed” signal

void
user_function (GdkSeat       *seat,
               GdkDeviceTool *tool,
               gpointer       user_data)

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

Flags: Run Last

Since: 3.22