gdk/auto/

device.rs

// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// DO NOT EDIT

use crate::{
    Atom, AxisFlags, AxisUse, DeviceManager, DeviceTool, DeviceType, Display, InputMode,
    InputSource, ModifierType, Screen, Seat, Window,
};
use glib::{
    prelude::*,
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::{boxed::Box as Box_, fmt, mem, mem::transmute, ptr};

glib::wrapper! {
    /// The [`Device`][crate::Device] object represents a single input device, such
    /// as a keyboard, a mouse, a touchpad, etc.
    ///
    /// See the [`DeviceManager`][crate::DeviceManager] documentation for more information
    /// about the various kinds of master and slave devices, and their
    /// relationships.
    ///
    /// This is an Abstract Base Class, you cannot instantiate it.
    ///
    /// ## Properties
    ///
    ///
    /// #### `associated-device`
    ///  Associated pointer or keyboard with this device, if any. Devices of type [`DeviceType::Master`][crate::DeviceType::Master]
    /// always come in keyboard/pointer pairs. Other device types will have a [`None`] associated device.
    ///
    /// Readable
    ///
    ///
    /// #### `axes`
    ///  The axes currently available for this device.
    ///
    /// Readable
    ///
    ///
    /// #### `device-manager`
    ///  The [`DeviceManager`][crate::DeviceManager] the [`Device`][crate::Device] pertains to.
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `display`
    ///  The [`Display`][crate::Display] the [`Device`][crate::Device] pertains to.
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `has-cursor`
    ///  Whether the device is represented by a cursor on the screen. Devices of type
    /// [`DeviceType::Master`][crate::DeviceType::Master] will have [`true`] here.
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `input-mode`
    ///  Readable | Writeable
    ///
    ///
    /// #### `input-source`
    ///  Source type for the device.
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `n-axes`
    ///  Number of axes in the device.
    ///
    /// Readable
    ///
    ///
    /// #### `name`
    ///  The device name.
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `num-touches`
    ///  The maximal number of concurrent touches on a touch device.
    /// Will be 0 if the device is not a touch device or if the number
    /// of touches is unknown.
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `product-id`
    ///  Product ID of this device, see [`DeviceExt::product_id()`][crate::prelude::DeviceExt::product_id()].
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `seat`
    ///  [`Seat`][crate::Seat] of this device.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `tool`
    ///  Readable
    ///
    ///
    /// #### `type`
    ///  Device role in the device manager.
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `vendor-id`
    ///  Vendor ID of this device, see [`DeviceExt::vendor_id()`][crate::prelude::DeviceExt::vendor_id()].
    ///
    /// Readable | Writeable | Construct Only
    ///
    /// ## Signals
    ///
    ///
    /// #### `changed`
    ///  The ::changed signal is emitted either when the [`Device`][crate::Device]
    /// has changed the number of either axes or keys. For example
    /// In X this will normally happen when the slave device routing
    /// events through the master device changes (for example, user
    /// switches from the USB mouse to a tablet), in that case the
    /// master device will change to reflect the new slave device
    /// axes and keys.
    ///
    ///
    ///
    ///
    /// #### `tool-changed`
    ///  The ::tool-changed signal is emitted on pen/eraser
    /// `GdkDevices` whenever tools enter or leave proximity.
    ///
    ///
    ///
    /// # Implements
    ///
    /// [`DeviceExt`][trait@crate::prelude::DeviceExt], [`DeviceExtManual`][trait@crate::prelude::DeviceExtManual]
    #[doc(alias = "GdkDevice")]
    pub struct Device(Object<ffi::GdkDevice>);

    match fn {
        type_ => || ffi::gdk_device_get_type(),
    }
}

impl Device {
    pub const NONE: Option<&'static Device> = None;
}

mod sealed {
    pub trait Sealed {}
    impl<T: super::IsA<super::Device>> Sealed for T {}
}

/// Trait containing all [`struct@Device`] methods.
///
/// # Implementors
///
/// [`DevicePad`][struct@crate::DevicePad], [`Device`][struct@crate::Device]
pub trait DeviceExt: IsA<Device> + sealed::Sealed + 'static {
    /// Returns the associated device to `self`, if `self` is of type
    /// [`DeviceType::Master`][crate::DeviceType::Master], it will return the paired pointer or
    /// keyboard.
    ///
    /// If `self` is of type [`DeviceType::Slave`][crate::DeviceType::Slave], it will return
    /// the master device to which `self` is attached to.
    ///
    /// If `self` is of type [`DeviceType::Floating`][crate::DeviceType::Floating], [`None`] will be
    /// returned, as there is no associated device.
    ///
    /// # Returns
    ///
    /// The associated device, or
    ///  [`None`]
    #[doc(alias = "gdk_device_get_associated_device")]
    #[doc(alias = "get_associated_device")]
    #[must_use]
    fn associated_device(&self) -> Option<Device> {
        unsafe {
            from_glib_none(ffi::gdk_device_get_associated_device(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Returns the axes currently available on the device.
    #[doc(alias = "gdk_device_get_axes")]
    #[doc(alias = "get_axes")]
    fn axes(&self) -> AxisFlags {
        unsafe { from_glib(ffi::gdk_device_get_axes(self.as_ref().to_glib_none().0)) }
    }

    //#[doc(alias = "gdk_device_get_axis")]
    //#[doc(alias = "get_axis")]
    //fn axis(&self, axes: &[f64], use_: AxisUse) -> Option<f64> {
    //    unsafe { TODO: call ffi:gdk_device_get_axis() }
    //}

    /// Returns the axis use for `index_`.
    /// ## `index_`
    /// the index of the axis.
    ///
    /// # Returns
    ///
    /// a [`AxisUse`][crate::AxisUse] specifying how the axis is used.
    #[doc(alias = "gdk_device_get_axis_use")]
    #[doc(alias = "get_axis_use")]
    fn axis_use(&self, index_: u32) -> AxisUse {
        unsafe {
            from_glib(ffi::gdk_device_get_axis_use(
                self.as_ref().to_glib_none().0,
                index_,
            ))
        }
    }

    //#[doc(alias = "gdk_device_get_axis_value")]
    //#[doc(alias = "get_axis_value")]
    //fn axis_value(&self, axes: &[f64], axis_label: &Atom) -> Option<f64> {
    //    unsafe { TODO: call ffi:gdk_device_get_axis_value() }
    //}

    /// Returns the device type for `self`.
    ///
    /// # Returns
    ///
    /// the [`DeviceType`][crate::DeviceType] for `self`.
    #[doc(alias = "gdk_device_get_device_type")]
    #[doc(alias = "get_device_type")]
    fn device_type(&self) -> DeviceType {
        unsafe {
            from_glib(ffi::gdk_device_get_device_type(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Returns the [`Display`][crate::Display] to which `self` pertains.
    ///
    /// # Returns
    ///
    /// a [`Display`][crate::Display]. This memory is owned
    ///  by GTK+, and must not be freed or unreffed.
    #[doc(alias = "gdk_device_get_display")]
    #[doc(alias = "get_display")]
    fn display(&self) -> Display {
        unsafe { from_glib_none(ffi::gdk_device_get_display(self.as_ref().to_glib_none().0)) }
    }

    /// Determines whether the pointer follows device motion.
    /// This is not meaningful for keyboard devices, which don't have a pointer.
    ///
    /// # Returns
    ///
    /// [`true`] if the pointer follows device motion
    #[doc(alias = "gdk_device_get_has_cursor")]
    #[doc(alias = "get_has_cursor")]
    fn has_cursor(&self) -> bool {
        unsafe {
            from_glib(ffi::gdk_device_get_has_cursor(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// If `index_` has a valid keyval, this function will return [`true`]
    /// and fill in `keyval` and `modifiers` with the keyval settings.
    /// ## `index_`
    /// the index of the macro button to get.
    ///
    /// # Returns
    ///
    /// [`true`] if keyval is set for `index`.
    ///
    /// ## `keyval`
    /// return value for the keyval.
    ///
    /// ## `modifiers`
    /// return value for modifiers.
    #[doc(alias = "gdk_device_get_key")]
    #[doc(alias = "get_key")]
    fn key(&self, index_: u32) -> Option<(u32, ModifierType)> {
        unsafe {
            let mut keyval = mem::MaybeUninit::uninit();
            let mut modifiers = mem::MaybeUninit::uninit();
            let ret = from_glib(ffi::gdk_device_get_key(
                self.as_ref().to_glib_none().0,
                index_,
                keyval.as_mut_ptr(),
                modifiers.as_mut_ptr(),
            ));
            if ret {
                Some((keyval.assume_init(), from_glib(modifiers.assume_init())))
            } else {
                None
            }
        }
    }

    /// Gets information about which window the given pointer device is in, based on events
    /// that have been received so far from the display server. If another application
    /// has a pointer grab, or this application has a grab with owner_events = [`false`],
    /// [`None`] may be returned even if the pointer is physically over one of this
    /// application's windows.
    ///
    /// # Returns
    ///
    /// the last window the device
    #[doc(alias = "gdk_device_get_last_event_window")]
    #[doc(alias = "get_last_event_window")]
    fn last_event_window(&self) -> Option<Window> {
        unsafe {
            from_glib_none(ffi::gdk_device_get_last_event_window(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Determines the mode of the device.
    ///
    /// # Returns
    ///
    /// a [`InputSource`][crate::InputSource]
    #[doc(alias = "gdk_device_get_mode")]
    #[doc(alias = "get_mode")]
    fn mode(&self) -> InputMode {
        unsafe { from_glib(ffi::gdk_device_get_mode(self.as_ref().to_glib_none().0)) }
    }

    /// Returns the number of axes the device currently has.
    ///
    /// # Returns
    ///
    /// the number of axes.
    #[doc(alias = "gdk_device_get_n_axes")]
    #[doc(alias = "get_n_axes")]
    fn n_axes(&self) -> i32 {
        unsafe { ffi::gdk_device_get_n_axes(self.as_ref().to_glib_none().0) }
    }

    /// Returns the number of keys the device currently has.
    ///
    /// # Returns
    ///
    /// the number of keys.
    #[doc(alias = "gdk_device_get_n_keys")]
    #[doc(alias = "get_n_keys")]
    fn n_keys(&self) -> i32 {
        unsafe { ffi::gdk_device_get_n_keys(self.as_ref().to_glib_none().0) }
    }

    /// Determines the name of the device.
    ///
    /// # Returns
    ///
    /// a name
    #[doc(alias = "gdk_device_get_name")]
    #[doc(alias = "get_name")]
    fn name(&self) -> Option<glib::GString> {
        unsafe { from_glib_none(ffi::gdk_device_get_name(self.as_ref().to_glib_none().0)) }
    }

    /// Gets the current location of `self`. As a slave device
    /// coordinates are those of its master pointer, This function
    /// may not be called on devices of type [`DeviceType::Slave`][crate::DeviceType::Slave],
    /// unless there is an ongoing grab on them, see `gdk_device_grab()`.
    ///
    /// # Returns
    ///
    ///
    /// ## `screen`
    /// location to store the [`Screen`][crate::Screen]
    ///  the `self` is on, or [`None`].
    ///
    /// ## `x`
    /// location to store root window X coordinate of `self`, or [`None`].
    ///
    /// ## `y`
    /// location to store root window Y coordinate of `self`, or [`None`].
    #[doc(alias = "gdk_device_get_position")]
    #[doc(alias = "get_position")]
    fn position(&self) -> (Screen, i32, i32) {
        unsafe {
            let mut screen = ptr::null_mut();
            let mut x = mem::MaybeUninit::uninit();
            let mut y = mem::MaybeUninit::uninit();
            ffi::gdk_device_get_position(
                self.as_ref().to_glib_none().0,
                &mut screen,
                x.as_mut_ptr(),
                y.as_mut_ptr(),
            );
            (from_glib_none(screen), x.assume_init(), y.assume_init())
        }
    }

    /// Gets the current location of `self` in double precision. As a slave device's
    /// coordinates are those of its master pointer, this function
    /// may not be called on devices of type [`DeviceType::Slave`][crate::DeviceType::Slave],
    /// unless there is an ongoing grab on them. See `gdk_device_grab()`.
    ///
    /// # Returns
    ///
    ///
    /// ## `screen`
    /// location to store the [`Screen`][crate::Screen]
    ///  the `self` is on, or [`None`].
    ///
    /// ## `x`
    /// location to store root window X coordinate of `self`, or [`None`].
    ///
    /// ## `y`
    /// location to store root window Y coordinate of `self`, or [`None`].
    #[doc(alias = "gdk_device_get_position_double")]
    #[doc(alias = "get_position_double")]
    fn position_double(&self) -> (Screen, f64, f64) {
        unsafe {
            let mut screen = ptr::null_mut();
            let mut x = mem::MaybeUninit::uninit();
            let mut y = mem::MaybeUninit::uninit();
            ffi::gdk_device_get_position_double(
                self.as_ref().to_glib_none().0,
                &mut screen,
                x.as_mut_ptr(),
                y.as_mut_ptr(),
            );
            (from_glib_none(screen), x.assume_init(), y.assume_init())
        }
    }

    /// Returns the product ID of this device, or [`None`] if this information couldn't
    /// be obtained. This ID is retrieved from the device, and is thus constant for
    /// it. See [`vendor_id()`][Self::vendor_id()] for more information.
    ///
    /// # Returns
    ///
    /// the product ID, or [`None`]
    #[doc(alias = "gdk_device_get_product_id")]
    #[doc(alias = "get_product_id")]
    fn product_id(&self) -> Option<glib::GString> {
        unsafe {
            from_glib_none(ffi::gdk_device_get_product_id(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Returns the [`Seat`][crate::Seat] the device belongs to.
    ///
    /// # Returns
    ///
    /// A [`Seat`][crate::Seat]. This memory is owned by GTK+ and
    ///  must not be freed.
    #[doc(alias = "gdk_device_get_seat")]
    #[doc(alias = "get_seat")]
    fn seat(&self) -> Option<Seat> {
        unsafe { from_glib_none(ffi::gdk_device_get_seat(self.as_ref().to_glib_none().0)) }
    }

    /// Determines the type of the device.
    ///
    /// # Returns
    ///
    /// a [`InputSource`][crate::InputSource]
    #[doc(alias = "gdk_device_get_source")]
    #[doc(alias = "get_source")]
    fn source(&self) -> InputSource {
        unsafe { from_glib(ffi::gdk_device_get_source(self.as_ref().to_glib_none().0)) }
    }

    //#[doc(alias = "gdk_device_get_state")]
    //#[doc(alias = "get_state")]
    //fn state(&self, window: &Window, axes: &[f64]) -> ModifierType {
    //    unsafe { TODO: call ffi:gdk_device_get_state() }
    //}

    /// Returns the vendor ID of this device, or [`None`] if this information couldn't
    /// be obtained. This ID is retrieved from the device, and is thus constant for
    /// it.
    ///
    /// This function, together with [`product_id()`][Self::product_id()], can be used to eg.
    /// compose `GSettings` paths to store settings for this device.
    ///
    ///
    ///
    /// **⚠️ The following code is in C ⚠️**
    ///
    /// ```C
    ///  static GSettings *
    ///  get_device_settings (GdkDevice *device)
    ///  {
    ///    const gchar *vendor, *product;
    ///    GSettings *settings;
    ///    GdkDevice *device;
    ///    gchar *path;
    ///
    ///    vendor = gdk_device_get_vendor_id (device);
    ///    product = gdk_device_get_product_id (device);
    ///
    ///    path = g_strdup_printf ("/org/example/app/devices/%s:%s/", vendor, product);
    ///    settings = g_settings_new_with_path (DEVICE_SCHEMA, path);
    ///    g_free (path);
    ///
    ///    return settings;
    ///  }
    /// ```
    ///
    /// # Returns
    ///
    /// the vendor ID, or [`None`]
    #[doc(alias = "gdk_device_get_vendor_id")]
    #[doc(alias = "get_vendor_id")]
    fn vendor_id(&self) -> Option<glib::GString> {
        unsafe {
            from_glib_none(ffi::gdk_device_get_vendor_id(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Obtains the window underneath `self`, returning the location of the device in `win_x` and `win_y`. Returns
    /// [`None`] if the window tree under `self` is not known to GDK (for example, belongs to another application).
    ///
    /// As a slave device coordinates are those of its master pointer, This
    /// function may not be called on devices of type [`DeviceType::Slave`][crate::DeviceType::Slave],
    /// unless there is an ongoing grab on them, see `gdk_device_grab()`.
    ///
    /// # Returns
    ///
    /// the [`Window`][crate::Window] under the
    /// device position, or [`None`].
    ///
    /// ## `win_x`
    /// return location for the X coordinate of the device location,
    ///  relative to the window origin, or [`None`].
    ///
    /// ## `win_y`
    /// return location for the Y coordinate of the device location,
    ///  relative to the window origin, or [`None`].
    #[doc(alias = "gdk_device_get_window_at_position")]
    #[doc(alias = "get_window_at_position")]
    fn window_at_position(&self) -> (Option<Window>, i32, i32) {
        unsafe {
            let mut win_x = mem::MaybeUninit::uninit();
            let mut win_y = mem::MaybeUninit::uninit();
            let ret = from_glib_none(ffi::gdk_device_get_window_at_position(
                self.as_ref().to_glib_none().0,
                win_x.as_mut_ptr(),
                win_y.as_mut_ptr(),
            ));
            (ret, win_x.assume_init(), win_y.assume_init())
        }
    }

    /// Obtains the window underneath `self`, returning the location of the device in `win_x` and `win_y` in
    /// double precision. Returns [`None`] if the window tree under `self` is not known to GDK (for example,
    /// belongs to another application).
    ///
    /// As a slave device coordinates are those of its master pointer, This
    /// function may not be called on devices of type [`DeviceType::Slave`][crate::DeviceType::Slave],
    /// unless there is an ongoing grab on them, see `gdk_device_grab()`.
    ///
    /// # Returns
    ///
    /// the [`Window`][crate::Window] under the
    ///  device position, or [`None`].
    ///
    /// ## `win_x`
    /// return location for the X coordinate of the device location,
    ///  relative to the window origin, or [`None`].
    ///
    /// ## `win_y`
    /// return location for the Y coordinate of the device location,
    ///  relative to the window origin, or [`None`].
    #[doc(alias = "gdk_device_get_window_at_position_double")]
    #[doc(alias = "get_window_at_position_double")]
    fn window_at_position_double(&self) -> (Option<Window>, f64, f64) {
        unsafe {
            let mut win_x = mem::MaybeUninit::uninit();
            let mut win_y = mem::MaybeUninit::uninit();
            let ret = from_glib_none(ffi::gdk_device_get_window_at_position_double(
                self.as_ref().to_glib_none().0,
                win_x.as_mut_ptr(),
                win_y.as_mut_ptr(),
            ));
            (ret, win_x.assume_init(), win_y.assume_init())
        }
    }

    /// Returns a `GList` of `GdkAtoms`, containing the labels for
    /// the axes that `self` currently has.
    ///
    /// # Returns
    ///
    ///
    ///  A `GList` of `GdkAtoms`, free with `g_list_free()`.
    #[doc(alias = "gdk_device_list_axes")]
    fn list_axes(&self) -> Vec<Atom> {
        unsafe {
            FromGlibPtrContainer::from_glib_container(ffi::gdk_device_list_axes(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// If the device if of type [`DeviceType::Master`][crate::DeviceType::Master], it will return
    /// the list of slave devices attached to it, otherwise it will return
    /// [`None`]
    ///
    /// # Returns
    ///
    ///
    ///  the list of slave devices, or [`None`]. The list must be
    ///  freed with `g_list_free()`, the contents of the list are
    ///  owned by GTK+ and should not be freed.
    #[doc(alias = "gdk_device_list_slave_devices")]
    fn list_slave_devices(&self) -> Vec<Device> {
        unsafe {
            FromGlibPtrContainer::from_glib_container(ffi::gdk_device_list_slave_devices(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Specifies how an axis of a device is used.
    /// ## `index_`
    /// the index of the axis
    /// ## `use_`
    /// specifies how the axis is used
    #[doc(alias = "gdk_device_set_axis_use")]
    fn set_axis_use(&self, index_: u32, use_: AxisUse) {
        unsafe {
            ffi::gdk_device_set_axis_use(self.as_ref().to_glib_none().0, index_, use_.into_glib());
        }
    }

    /// Specifies the X key event to generate when a macro button of a device
    /// is pressed.
    /// ## `index_`
    /// the index of the macro button to set
    /// ## `keyval`
    /// the keyval to generate
    /// ## `modifiers`
    /// the modifiers to set
    #[doc(alias = "gdk_device_set_key")]
    fn set_key(&self, index_: u32, keyval: u32, modifiers: ModifierType) {
        unsafe {
            ffi::gdk_device_set_key(
                self.as_ref().to_glib_none().0,
                index_,
                keyval,
                modifiers.into_glib(),
            );
        }
    }

    /// Sets a the mode of an input device. The mode controls if the
    /// device is active and whether the device’s range is mapped to the
    /// entire screen or to a single window.
    ///
    /// Note: This is only meaningful for floating devices, master devices (and
    /// slaves connected to these) drive the pointer cursor, which is not limited
    /// by the input mode.
    /// ## `mode`
    /// the input mode.
    ///
    /// # Returns
    ///
    /// [`true`] if the mode was successfully changed.
    #[doc(alias = "gdk_device_set_mode")]
    fn set_mode(&self, mode: InputMode) -> bool {
        unsafe {
            from_glib(ffi::gdk_device_set_mode(
                self.as_ref().to_glib_none().0,
                mode.into_glib(),
            ))
        }
    }

    /// Warps `self` in `display` to the point `x`,`y` on
    /// the screen `screen`, unless the device is confined
    /// to a window by a grab, in which case it will be moved
    /// as far as allowed by the grab. Warping the pointer
    /// creates events as if the user had moved the mouse
    /// instantaneously to the destination.
    ///
    /// Note that the pointer should normally be under the
    /// control of the user. This function was added to cover
    /// some rare use cases like keyboard navigation support
    /// for the color picker in the `GtkColorSelectionDialog`.
    /// ## `screen`
    /// the screen to warp `self` to.
    /// ## `x`
    /// the X coordinate of the destination.
    /// ## `y`
    /// the Y coordinate of the destination.
    #[doc(alias = "gdk_device_warp")]
    fn warp(&self, screen: &Screen, x: i32, y: i32) {
        unsafe {
            ffi::gdk_device_warp(
                self.as_ref().to_glib_none().0,
                screen.to_glib_none().0,
                x,
                y,
            );
        }
    }

    /// The [`DeviceManager`][crate::DeviceManager] the [`Device`][crate::Device] pertains to.
    #[doc(alias = "device-manager")]
    fn device_manager(&self) -> Option<DeviceManager> {
        ObjectExt::property(self.as_ref(), "device-manager")
    }

    #[doc(alias = "input-mode")]
    fn input_mode(&self) -> InputMode {
        ObjectExt::property(self.as_ref(), "input-mode")
    }

    #[doc(alias = "input-mode")]
    fn set_input_mode(&self, input_mode: InputMode) {
        ObjectExt::set_property(self.as_ref(), "input-mode", input_mode)
    }

    /// Source type for the device.
    #[doc(alias = "input-source")]
    fn input_source(&self) -> InputSource {
        ObjectExt::property(self.as_ref(), "input-source")
    }

    /// The maximal number of concurrent touches on a touch device.
    /// Will be 0 if the device is not a touch device or if the number
    /// of touches is unknown.
    #[doc(alias = "num-touches")]
    fn num_touches(&self) -> u32 {
        ObjectExt::property(self.as_ref(), "num-touches")
    }

    /// [`Seat`][crate::Seat] of this device.
    fn set_seat<P: IsA<Seat>>(&self, seat: Option<&P>) {
        ObjectExt::set_property(self.as_ref(), "seat", seat)
    }

    fn tool(&self) -> Option<DeviceTool> {
        ObjectExt::property(self.as_ref(), "tool")
    }

    /// Device role in the device manager.
    #[doc(alias = "type")]
    fn type_(&self) -> DeviceType {
        ObjectExt::property(self.as_ref(), "type")
    }

    /// The ::changed signal is emitted either when the [`Device`][crate::Device]
    /// has changed the number of either axes or keys. For example
    /// In X this will normally happen when the slave device routing
    /// events through the master device changes (for example, user
    /// switches from the USB mouse to a tablet), in that case the
    /// master device will change to reflect the new slave device
    /// axes and keys.
    #[doc(alias = "changed")]
    fn connect_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn changed_trampoline<P: IsA<Device>, F: Fn(&P) + 'static>(
            this: *mut ffi::GdkDevice,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(Device::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"changed\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    changed_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    /// The ::tool-changed signal is emitted on pen/eraser
    /// `GdkDevices` whenever tools enter or leave proximity.
    /// ## `tool`
    /// The new current tool
    #[doc(alias = "tool-changed")]
    fn connect_tool_changed<F: Fn(&Self, &DeviceTool) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn tool_changed_trampoline<
            P: IsA<Device>,
            F: Fn(&P, &DeviceTool) + 'static,
        >(
            this: *mut ffi::GdkDevice,
            tool: *mut ffi::GdkDeviceTool,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(
                Device::from_glib_borrow(this).unsafe_cast_ref(),
                &from_glib_borrow(tool),
            )
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"tool-changed\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    tool_changed_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "associated-device")]
    fn connect_associated_device_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_associated_device_trampoline<
            P: IsA<Device>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::GdkDevice,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(Device::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::associated-device\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_associated_device_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "axes")]
    fn connect_axes_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_axes_trampoline<P: IsA<Device>, F: Fn(&P) + 'static>(
            this: *mut ffi::GdkDevice,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(Device::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::axes\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_axes_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "input-mode")]
    fn connect_input_mode_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_input_mode_trampoline<P: IsA<Device>, F: Fn(&P) + 'static>(
            this: *mut ffi::GdkDevice,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(Device::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::input-mode\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_input_mode_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "n-axes")]
    fn connect_n_axes_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_n_axes_trampoline<P: IsA<Device>, F: Fn(&P) + 'static>(
            this: *mut ffi::GdkDevice,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(Device::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::n-axes\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_n_axes_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "seat")]
    fn connect_seat_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_seat_trampoline<P: IsA<Device>, F: Fn(&P) + 'static>(
            this: *mut ffi::GdkDevice,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(Device::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::seat\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_seat_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "tool")]
    fn connect_tool_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_tool_trampoline<P: IsA<Device>, F: Fn(&P) + 'static>(
            this: *mut ffi::GdkDevice,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(Device::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::tool\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_tool_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "type")]
    fn connect_type_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_type_trampoline<P: IsA<Device>, F: Fn(&P) + 'static>(
            this: *mut ffi::GdkDevice,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(Device::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::type\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_type_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl<O: IsA<Device>> DeviceExt for O {}

impl fmt::Display for Device {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        f.write_str("Device")
    }
}