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_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_get_pointer ()
GdkDevice *
gdk_seat_get_pointer (GdkSeat *seat);
Returns the master device that routes pointer events.
Returns
a master GdkDevice with pointer
capabilities. This object is owned by GTK+ and must not be freed.
[transfer none][nullable]
Since: 3.20
gdk_seat_get_keyboard ()
GdkDevice *
gdk_seat_get_keyboard (GdkSeat *seat);
Returns the master device that routes keyboard events.
Returns
a master GdkDevice with keyboard
capabilities. This object is owned by GTK+ and must not be freed.
[transfer none][nullable]
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.
Returns
A list of GdkDevices.
The list must be freed with g_list_free(), the elements are owned
by GDK and must not be freed.
[transfer container][element-type GdkDevice]
Since: 3.20