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

#include <gdkmm/seat.h>

Inheritance diagram for Gdk::Seat:

Public Types
enum class	Capabilities { Capabilities::NONE = 0x0 , Capabilities::POINTER = 1 << 0 , Capabilities::TOUCH = 1 << 1 , Capabilities::TABLET_STYLUS = 1 << 2 , Capabilities::KEYBOARD = 1 << 3 , Capabilities::TABLET_PAD = 1 << 4 , Capabilities::ALL_POINTING = 0x7 , Capabilities::ALL = 0x1F }
	Flags describing the seat capabilities. 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.

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

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

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

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

Capabilities	get_capabilities () const
	Returns the capabilities this `Gdk::Seat` currently has.

std::vector< Glib::RefPtr< Device > >	get_devices (Capabilities capabilities)
	Returns the devices that match the given capabilities.

std::vector< Glib::RefPtr< const Device > >	get_devices (Capabilities capabilities) const
	Returns the devices that match the given capabilities.

std::vector< Glib::RefPtr< DeviceTool > >	get_tools ()
	Returns all `Gdk::DeviceTools` that are known to the application.

std::vector< Glib::RefPtr< const DeviceTool > >	get_tools () const
	Returns all `Gdk::DeviceTools` that are known to the application.

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

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

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

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

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

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

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

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

Glib::SignalProxy< void(const Glib::RefPtr< DeviceTool > &)	signal_tool_added )()

Glib::SignalProxy< void(const Glib::RefPtr< DeviceTool > &)	signal_tool_removed )()

Protected Member Functions
	Seat ()

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

Detailed Description

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

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()

Capabilities Gdk::Seat::get_capabilities ( ) const

Returns the capabilities this Gdk::Seat currently has.

Returns: The seat capabilities.

◆ get_devices() [1/2]

std::vector< Glib::RefPtr< Device > > Gdk::Seat::get_devices ( Capabilities capabilities )

Returns the devices that match the given capabilities.

Parameters

capabilities Capabilities to get devices for.

Returns: A list of Gdk::Devices.

◆ get_devices() [2/2]

std::vector< Glib::RefPtr< const Device > > Gdk::Seat::get_devices ( Capabilities capabilities ) const

Returns the devices that match the given capabilities.

Parameters

capabilities Capabilities to get devices for.

Returns: A list of Gdk::Devices.

◆ 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 device that routes keyboard events.

Returns: A 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 device that routes keyboard events.

Returns: A 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 device that routes pointer events.

Returns: A 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 device that routes pointer events.

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

◆ get_tools() [1/2]

std::vector< Glib::RefPtr< DeviceTool > > Gdk::Seat::get_tools ( )

Returns all Gdk::DeviceTools that are known to the application.

Returns: A list of tools.

◆ get_tools() [2/2]

std::vector< Glib::RefPtr< const DeviceTool > > Gdk::Seat::get_tools ( ) const

Returns all Gdk::DeviceTools that are known to the application.

Returns: A list of tools.

◆ 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.

◆ 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.

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

Friends And Related Symbol 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.

Member Data Documentation

◆ 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

Emitted when a new input device is related to this seat.

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

Emitted when an input device is removed (e.g. unplugged).

Parameters

device The just removed Gdk::Device.

◆ signal_tool_added

Glib::SignalProxy< void(const Glib::RefPtr< DeviceTool > &) Gdk::Seat::signal_tool_added) ()

Slot Prototype:: void on_my_tool_added(const Glib::RefPtr<DeviceTool>& device)

Flags: Run Last

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::signal_tool_changed() signal accordingly.

A same tool may be used by several devices.

Since gtkmm 3.94

Parameters

device The new Gdk::DeviceTool known to the seat.

◆ signal_tool_removed

Glib::SignalProxy< void(const Glib::RefPtr< DeviceTool > &) Gdk::Seat::signal_tool_removed) ()

Slot Prototype:: void on_my_tool_removed(const Glib::RefPtr<DeviceTool>& device)

Flags: Run Last

Emitted whenever a tool is no longer known to this seat.

Since gtkmm 3.94

Parameters

device The just removed Gdk::DeviceTool.

Public Types

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Related Symbols

Detailed Description

Constructor & Destructor Documentation

◆ Seat() [1/2]

◆ ~Seat()

◆ Seat() [2/2]

Member Function Documentation

◆ get_capabilities()

◆ get_devices() [1/2]

◆ get_devices() [2/2]

◆ 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_tools() [1/2]

◆ get_tools() [2/2]

◆ get_type()

◆ gobj() [1/2]

◆ gobj() [2/2]

◆ gobj_copy()

◆ operator=()

◆ property_display()

Friends And Related Symbol Documentation

◆ wrap()

Member Data Documentation

◆ signal_device_added

◆ signal_device_removed

◆ signal_tool_added

◆ signal_tool_removed