A Gdk::Seat object represents a collection of input devices that belong to a user. More...

#include <gdkmm/seat.h>

Inherits Glib::Object.

Public Types
typedef sigc::slot< void, const Glib::RefPtr< Window > & >	SlotGrabPrepare
	For instance, void on_grab_prepare(const Glib::RefPtr<Gdk::Window>& window);. More...

Public Member Functions
	Seat (Seat && src) noexcept

Seat &	operator= (Seat && src) noexcept

	~Seat () noexcept override

GdkSeat *	gobj ()
	Provides access to the underlying C GObject. More...

const GdkSeat *	gobj () const
	Provides access to the underlying C GObject. More...

GdkSeat *	gobj_copy ()
	Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...

GrabStatus	grab (const Glib::RefPtr< Window > & window, SeatCapabilities capabilities, bool owner_events, const Glib::RefPtr< Cursor > & cursor=Glib::RefPtr< Cursor >(), const GdkEvent * event=nullptr, const SlotGrabPrepare & slot=SlotGrabPrepare())
	Grabs the seat so that all events corresponding to the given capabilities are passed to this application until the seat is ungrabbed with ungrab(), or the window becomes hidden. More...

void	ungrab ()
	Releases a grab added through grab(). More...

Glib::RefPtr< Display >	get_display ()
	Returns the Gdk::Display this seat belongs to. More...

Glib::RefPtr< const Display >	get_display () const
	Returns the Gdk::Display this seat belongs to. More...

SeatCapabilities	get_capabilities () const
	Returns the capabilities this Gdk::Seat currently has. More...

std::vector< Glib::RefPtr< Device > >	get_slaves (SeatCapabilities capabilities)
	Returns the slave devices that match the given capabilities. More...

std::vector< Glib::RefPtr< const Device > >	get_slaves (SeatCapabilities capabilities) const
	Returns the slave devices that match the given capabilities. More...

Glib::RefPtr< Device >	get_pointer ()
	Returns the master device that routes pointer events. More...

Glib::RefPtr< const Device >	get_pointer () const
	Returns the master device that routes pointer events. More...

Glib::RefPtr< Device >	get_keyboard ()
	Returns the master device that routes keyboard events. More...

Glib::RefPtr< const Device >	get_keyboard () const
	Returns the master device that routes keyboard events. More...

Glib::SignalProxy< void, const Glib::RefPtr< Device > & >	signal_device_added ()

Glib::SignalProxy< void, const Glib::RefPtr< Device > & >	signal_device_removed ()

Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Display > >	property_display () const
	Gdk::Display of this seat. More...

Static Public Member Functions
static GType	get_type ()
	Get the GType for this class, for use with the underlying GObject type system. More...

Protected Member Functions
	Seat ()

Related Functions
(Note that these are not member functions.)
Glib::RefPtr< Gdk::Seat >	wrap (GdkSeat * object, bool take_copy=false)
	A Glib::wrap() method for this object. More...

Detailed Description

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

Since gtkmm 3.20:

Member Typedef Documentation

◆ SlotGrabPrepare

typedef sigc::slot<void, const Glib::RefPtr<Window>&> Gdk::Seat::SlotGrabPrepare

For instance,
void on_grab_prepare(const Glib::RefPtr<Gdk::Window>& window);.

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.

Parameters

window The Gdk::Window being grabbed.

Since gtkmm 3.20:

Constructor & Destructor Documentation

◆ Seat() [1/2]

Gdk::Seat::Seat ( Seat && src )

noexcept

◆ ~Seat()

Gdk::Seat::~Seat ( )

overridenoexcept

◆ Seat() [2/2]

Gdk::Seat::Seat ( )

protected

Member Function Documentation

◆ get_capabilities()

SeatCapabilities Gdk::Seat::get_capabilities ( ) const

Returns the capabilities this Gdk::Seat currently has.

Since gtkmm 3.20:

Returns: The seat capabilities.

◆ get_display() [1/2]

Glib::RefPtr< Display > Gdk::Seat::get_display ( )

Returns the Gdk::Display this seat belongs to.

Returns: A Gdk::Display. This object is owned by GTK+ and must not be freed.

◆ get_display() [2/2]

Glib::RefPtr< const Display > Gdk::Seat::get_display ( ) const

Returns the Gdk::Display this seat belongs to.

Returns: A Gdk::Display. This object is owned by GTK+ and must not be freed.

◆ get_keyboard() [1/2]

Glib::RefPtr< Device > Gdk::Seat::get_keyboard ( )

Returns the master device that routes keyboard events.

Since gtkmm 3.20:

Returns: A master Gdk::Device with keyboard capabilities. This object is owned by GTK+ and must not be freed.

◆ get_keyboard() [2/2]

Glib::RefPtr< const Device > Gdk::Seat::get_keyboard ( ) const

Returns the master device that routes keyboard events.

Since gtkmm 3.20:

Returns: A master Gdk::Device with keyboard capabilities. This object is owned by GTK+ and must not be freed.

◆ get_pointer() [1/2]

Glib::RefPtr< Device > Gdk::Seat::get_pointer ( )

Returns the master device that routes pointer events.

Since gtkmm 3.20:

Returns: A master Gdk::Device with pointer capabilities. This object is owned by GTK+ and must not be freed.

◆ get_pointer() [2/2]

Glib::RefPtr< const Device > Gdk::Seat::get_pointer ( ) const

Returns the master device that routes pointer events.

Since gtkmm 3.20:

Returns: A master Gdk::Device with pointer capabilities. This object is owned by GTK+ and must not be freed.

◆ get_slaves() [1/2]

std::vector< Glib::RefPtr< Device > > Gdk::Seat::get_slaves ( SeatCapabilities capabilities )

Returns the slave devices that match the given capabilities.

Since gtkmm 3.20:

Parameters

capabilities Capabilities to get devices for.

Returns: A list of Gdk::Devices.

◆ get_slaves() [2/2]

std::vector< Glib::RefPtr< const Device > > Gdk::Seat::get_slaves ( SeatCapabilities capabilities ) const

Returns the slave devices that match the given capabilities.

Since gtkmm 3.20:

Parameters

capabilities Capabilities to get devices for.

Returns: A list of Gdk::Devices.

◆ get_type()

static GType Gdk::Seat::get_type ( )

static

Get the GType for this class, for use with the underlying GObject type system.

◆ gobj() [1/2]

GdkSeat * Gdk::Seat::gobj ( )

inline

Provides access to the underlying C GObject.

◆ gobj() [2/2]

const GdkSeat * Gdk::Seat::gobj ( ) const

inline

Provides access to the underlying C GObject.

◆ gobj_copy()

GdkSeat * Gdk::Seat::gobj_copy ( )

Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.

◆ grab()

GrabStatus Gdk::Seat::grab	(	const Glib::RefPtr< Window > &	window,
		SeatCapabilities	capabilities,
		bool	owner_events,
		const Glib::RefPtr< Cursor > &	cursor = `Glib::RefPtr< Cursor >()`,
		const GdkEvent *	event = `nullptr`,
		const SlotGrabPrepare &	slot = `SlotGrabPrepare()`
	)

Grabs the seat so that all events corresponding to the given capabilities are passed to this application until the seat is ungrabbed with 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 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.

Since gtkmm 3.20:

Parameters

window	The Gdk::Window which will own the grab.
capabilities	Capabilities that will be grabbed.
owner_events	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	The cursor to display while the grab is active. If this is `nullptr` then the normal cursors are used for window and its descendants, and the cursor for window is used elsewhere.
event	The event that is triggering the grab, or `nullptr` if none is available.
slot	Function to prepare the window to be grabbed, it can be `nullptr` if window is visible before this call.

Returns: Gdk::GRAB_SUCCESS if the grab was successful.

◆ operator=()

Seat & Gdk::Seat::operator= ( Seat && src )

noexcept

◆ property_display()

Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Display > > Gdk::Seat::property_display ( ) const

Gdk::Display of this seat.

Since gtkmm 3.20:

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ signal_device_added()

Glib::SignalProxy< void, const Glib::RefPtr< Device > & > Gdk::Seat::signal_device_added ( )

Slot Prototype:: void on_my_device_added(const Glib::RefPtr<Device>& device)

Flags: Run Last

The signal_device_added() signal is emitted when a new input device is related to this seat.

Since gtkmm 3.20:

Parameters

device The newly added Gdk::Device.

◆ signal_device_removed()

Glib::SignalProxy< void, const Glib::RefPtr< Device > & > Gdk::Seat::signal_device_removed ( )

Slot Prototype:: void on_my_device_removed(const Glib::RefPtr<Device>& device)

Flags: Run Last

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

Since gtkmm 3.20:

Parameters

device The just removed Gdk::Device.

◆ ungrab()

void Gdk::Seat::ungrab ( )

Releases a grab added through grab().

Since gtkmm 3.20:

Friends And Related Function Documentation

◆ wrap()

Glib::RefPtr< Gdk::Seat > wrap	(	GdkSeat *	object,
		bool	take_copy = `false`
	)

Parameters

object	The C instance.
take_copy	False if the result should take ownership of the C instance. True if it should take a new copy or ref.

Returns: A C++ instance that wraps this C instance.

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Related Functions

Detailed Description

Member Typedef Documentation

◆ SlotGrabPrepare

Constructor & Destructor Documentation

◆ Seat() [1/2]

◆ ~Seat()

◆ Seat() [2/2]

Member Function Documentation

◆ get_capabilities()

◆ get_display() [1/2]

◆ get_display() [2/2]

◆ get_keyboard() [1/2]

◆ get_keyboard() [2/2]

◆ get_pointer() [1/2]

◆ get_pointer() [2/2]

◆ get_slaves() [1/2]

◆ get_slaves() [2/2]

◆ get_type()

◆ gobj() [1/2]

◆ gobj() [2/2]

◆ gobj_copy()

◆ grab()

◆ operator=()

◆ property_display()

◆ signal_device_added()

◆ signal_device_removed()

◆ ungrab()

Friends And Related Function Documentation

◆ wrap()