// 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;
#[cfg(any(feature = "v3_22", feature = "dox"))]
#[cfg_attr(feature = "dox", doc(cfg(feature = "v3_22")))]
use crate::AxisFlags;
use crate::AxisUse;
use crate::Cursor;
use crate::DeviceManager;
#[cfg(any(feature = "v3_22", feature = "dox"))]
#[cfg_attr(feature = "dox", doc(cfg(feature = "v3_22")))]
use crate::DeviceTool;
use crate::DeviceType;
use crate::Display;
use crate::EventMask;
use crate::GrabOwnership;
use crate::GrabStatus;
use crate::InputMode;
use crate::InputSource;
use crate::ModifierType;
use crate::Screen;
#[cfg(any(feature = "v3_20", feature = "dox"))]
#[cfg_attr(feature = "dox", doc(cfg(feature = "v3_20")))]
use crate::Seat;
use crate::Window;
use glib::object::ObjectType as ObjectType_;
use glib::signal::connect_raw;
use glib::signal::SignalHandlerId;
use glib::translate::*;
use glib::StaticType;
use glib::ToValue;
use std::boxed::Box as Box_;
use std::fmt;
use std::mem;
use std::mem::transmute;
use std::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.
    #[doc(alias = "GdkDevice")]
    pub struct Device(Object<ffi::GdkDevice>);

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

impl Device {
    /// 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]
    pub fn associated_device(&self) -> Option<Device> {
        unsafe { from_glib_none(ffi::gdk_device_get_associated_device(self.to_glib_none().0)) }
    }

    /// Returns the axes currently available on the device.
    #[cfg(any(feature = "v3_22", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v3_22")))]
    #[doc(alias = "gdk_device_get_axes")]
    #[doc(alias = "get_axes")]
    pub fn axes(&self) -> AxisFlags {
        unsafe { from_glib(ffi::gdk_device_get_axes(self.to_glib_none().0)) }
    }

    //#[doc(alias = "gdk_device_get_axis")]
    //#[doc(alias = "get_axis")]
    //pub 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")]
    pub fn axis_use(&self, index_: u32) -> AxisUse {
        unsafe { from_glib(ffi::gdk_device_get_axis_use(self.to_glib_none().0, index_)) }
    }

    //#[doc(alias = "gdk_device_get_axis_value")]
    //#[doc(alias = "get_axis_value")]
    //pub 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")]
    pub fn device_type(&self) -> DeviceType {
        unsafe { from_glib(ffi::gdk_device_get_device_type(self.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")]
    pub fn display(&self) -> Display {
        unsafe { from_glib_none(ffi::gdk_device_get_display(self.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")]
    pub fn has_cursor(&self) -> bool {
        unsafe { from_glib(ffi::gdk_device_get_has_cursor(self.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")]
    pub 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.to_glib_none().0,
                index_,
                keyval.as_mut_ptr(),
                modifiers.as_mut_ptr(),
            ));
            let keyval = keyval.assume_init();
            let modifiers = modifiers.assume_init();
            if ret {
                Some((keyval, from_glib(modifiers)))
            } 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")]
    pub fn last_event_window(&self) -> Option<Window> {
        unsafe { from_glib_none(ffi::gdk_device_get_last_event_window(self.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")]
    pub fn mode(&self) -> InputMode {
        unsafe { from_glib(ffi::gdk_device_get_mode(self.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")]
    pub fn n_axes(&self) -> i32 {
        unsafe { ffi::gdk_device_get_n_axes(self.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")]
    pub fn n_keys(&self) -> i32 {
        unsafe { ffi::gdk_device_get_n_keys(self.to_glib_none().0) }
    }

    /// Determines the name of the device.
    ///
    /// # Returns
    ///
    /// a name
    #[doc(alias = "gdk_device_get_name")]
    #[doc(alias = "get_name")]
    pub fn name(&self) -> Option<glib::GString> {
        unsafe { from_glib_none(ffi::gdk_device_get_name(self.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 [`grab()`][Self::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")]
    pub 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.to_glib_none().0,
                &mut screen,
                x.as_mut_ptr(),
                y.as_mut_ptr(),
            );
            let x = x.assume_init();
            let y = y.assume_init();
            (from_glib_none(screen), x, y)
        }
    }

    /// 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 [`grab()`][Self::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")]
    pub 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.to_glib_none().0,
                &mut screen,
                x.as_mut_ptr(),
                y.as_mut_ptr(),
            );
            let x = x.assume_init();
            let y = y.assume_init();
            (from_glib_none(screen), x, y)
        }
    }

    /// 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")]
    pub fn product_id(&self) -> Option<glib::GString> {
        unsafe { from_glib_none(ffi::gdk_device_get_product_id(self.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.
    #[cfg(any(feature = "v3_20", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v3_20")))]
    #[doc(alias = "gdk_device_get_seat")]
    #[doc(alias = "get_seat")]
    pub fn seat(&self) -> Option<Seat> {
        unsafe { from_glib_none(ffi::gdk_device_get_seat(self.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")]
    pub fn source(&self) -> InputSource {
        unsafe { from_glib(ffi::gdk_device_get_source(self.to_glib_none().0)) }
    }

    //#[doc(alias = "gdk_device_get_state")]
    //#[doc(alias = "get_state")]
    //pub 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")]
    pub fn vendor_id(&self) -> Option<glib::GString> {
        unsafe { from_glib_none(ffi::gdk_device_get_vendor_id(self.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 [`grab()`][Self::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")]
    pub 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.to_glib_none().0,
                win_x.as_mut_ptr(),
                win_y.as_mut_ptr(),
            ));
            let win_x = win_x.assume_init();
            let win_y = win_y.assume_init();
            (ret, win_x, win_y)
        }
    }

    /// 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 [`grab()`][Self::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")]
    pub 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.to_glib_none().0,
                win_x.as_mut_ptr(),
                win_y.as_mut_ptr(),
            ));
            let win_x = win_x.assume_init();
            let win_y = win_y.assume_init();
            (ret, win_x, win_y)
        }
    }

    /// Grabs the device so that all events coming from this device are passed to
    /// this application until the device is ungrabbed with [`ungrab()`][Self::ungrab()],
    /// or the window becomes unviewable. This overrides any previous grab on the device
    /// by this client.
    ///
    /// Note that `self` and `window` need to be on the same display.
    ///
    /// Device grabs are used for operations which need complete control over the
    /// given device events (either pointer or keyboard). For example in GTK+ this
    /// is used for Drag and Drop operations, popup menus and such.
    ///
    /// Note that if the event mask of an X window has selected both button press
    /// and button release events, then a button press event will cause an automatic
    /// pointer grab until the button is released. X does this automatically since
    /// most applications expect to receive button press and release events in pairs.
    /// It is equivalent to a pointer grab on the window with `owner_events` set to
    /// [`true`].
    ///
    /// 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 [`EventGrabBroken`][crate::EventGrabBroken]
    /// events that are emitted when the grab ends unvoluntarily.
    ///
    /// # Deprecated since 3.20
    ///
    /// Use [`Seat::grab()`][crate::Seat::grab()] instead.
    /// ## `window`
    /// the [`Window`][crate::Window] which will own the grab (the grab window)
    /// ## `grab_ownership`
    /// specifies the grab ownership.
    /// ## `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.
    /// ## `event_mask`
    /// specifies the event mask, which is used in accordance with
    ///  `owner_events`.
    /// ## `cursor`
    /// the cursor to display while the grab is active if the device is
    ///  a pointer. If this is [`None`] then the normal cursors are used for
    ///  `window` and its descendants, and the cursor for `window` is used
    ///  elsewhere.
    /// ## `time_`
    /// the timestamp of the event which led to this pointer grab. This
    ///  usually comes from the `GdkEvent` struct, though `GDK_CURRENT_TIME`
    ///  can be used if the time isn’t known.
    ///
    /// # Returns
    ///
    /// [`GrabStatus::Success`][crate::GrabStatus::Success] if the grab was successful.
    #[cfg_attr(feature = "v3_20", deprecated = "Since 3.20")]
    #[doc(alias = "gdk_device_grab")]
    pub fn grab(
        &self,
        window: &Window,
        grab_ownership: GrabOwnership,
        owner_events: bool,
        event_mask: EventMask,
        cursor: Option<&Cursor>,
        time_: u32,
    ) -> GrabStatus {
        unsafe {
            from_glib(ffi::gdk_device_grab(
                self.to_glib_none().0,
                window.to_glib_none().0,
                grab_ownership.into_glib(),
                owner_events.into_glib(),
                event_mask.into_glib(),
                cursor.to_glib_none().0,
                time_,
            ))
        }
    }

    /// 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")]
    pub fn list_axes(&self) -> Vec<Atom> {
        unsafe {
            FromGlibPtrContainer::from_glib_container(ffi::gdk_device_list_axes(
                self.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")]
    pub fn list_slave_devices(&self) -> Vec<Device> {
        unsafe {
            FromGlibPtrContainer::from_glib_container(ffi::gdk_device_list_slave_devices(
                self.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")]
    pub fn set_axis_use(&self, index_: u32, use_: AxisUse) {
        unsafe {
            ffi::gdk_device_set_axis_use(self.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")]
    pub fn set_key(&self, index_: u32, keyval: u32, modifiers: ModifierType) {
        unsafe {
            ffi::gdk_device_set_key(self.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")]
    pub fn set_mode(&self, mode: InputMode) -> bool {
        unsafe {
            from_glib(ffi::gdk_device_set_mode(
                self.to_glib_none().0,
                mode.into_glib(),
            ))
        }
    }

    /// Release any grab on `self`.
    ///
    /// # Deprecated since 3.20
    ///
    /// Use [`Seat::ungrab()`][crate::Seat::ungrab()] instead.
    /// ## `time_`
    /// a timestap (e.g. `GDK_CURRENT_TIME`).
    #[cfg_attr(feature = "v3_20", deprecated = "Since 3.20")]
    #[doc(alias = "gdk_device_ungrab")]
    pub fn ungrab(&self, time_: u32) {
        unsafe {
            ffi::gdk_device_ungrab(self.to_glib_none().0, time_);
        }
    }

    /// 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")]
    pub fn warp(&self, screen: &Screen, x: i32, y: i32) {
        unsafe {
            ffi::gdk_device_warp(self.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")]
    pub fn device_manager(&self) -> Option<DeviceManager> {
        glib::ObjectExt::property(self, "device-manager")
    }

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

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

    /// Source type for the device.
    #[doc(alias = "input-source")]
    pub fn input_source(&self) -> InputSource {
        glib::ObjectExt::property(self, "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.
    #[cfg(any(feature = "v3_20", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v3_20")))]
    #[doc(alias = "num-touches")]
    pub fn num_touches(&self) -> u32 {
        glib::ObjectExt::property(self, "num-touches")
    }

    /// [`Seat`][crate::Seat] of this device.
    #[cfg(any(feature = "v3_20", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v3_20")))]
    pub fn set_seat(&self, seat: Option<&Seat>) {
        glib::ObjectExt::set_property(self, "seat", &seat)
    }

    #[cfg(any(feature = "v3_22", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v3_22")))]
    pub fn tool(&self) -> Option<DeviceTool> {
        glib::ObjectExt::property(self, "tool")
    }

    /// Device role in the device manager.
    #[doc(alias = "type")]
    pub fn type_(&self) -> DeviceType {
        glib::ObjectExt::property(self, "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")]
    pub fn connect_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn changed_trampoline<F: Fn(&Device) + 'static>(
            this: *mut ffi::GdkDevice,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        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::<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
    #[cfg(any(feature = "v3_22", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v3_22")))]
    #[doc(alias = "tool-changed")]
    pub fn connect_tool_changed<F: Fn(&Self, &DeviceTool) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn tool_changed_trampoline<F: Fn(&Device, &DeviceTool) + 'static>(
            this: *mut ffi::GdkDevice,
            tool: *mut ffi::GdkDeviceTool,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this), &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::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "associated-device")]
    pub fn connect_associated_device_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_associated_device_trampoline<F: Fn(&Device) + 'static>(
            this: *mut ffi::GdkDevice,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        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::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[cfg(any(feature = "v3_22", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v3_22")))]
    #[doc(alias = "axes")]
    pub fn connect_axes_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_axes_trampoline<F: Fn(&Device) + 'static>(
            this: *mut ffi::GdkDevice,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        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::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "input-mode")]
    pub fn connect_input_mode_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_input_mode_trampoline<F: Fn(&Device) + 'static>(
            this: *mut ffi::GdkDevice,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        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::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "n-axes")]
    pub fn connect_n_axes_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_n_axes_trampoline<F: Fn(&Device) + 'static>(
            this: *mut ffi::GdkDevice,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        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::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[cfg(any(feature = "v3_20", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v3_20")))]
    #[doc(alias = "seat")]
    pub fn connect_seat_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_seat_trampoline<F: Fn(&Device) + 'static>(
            this: *mut ffi::GdkDevice,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        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::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[cfg(any(feature = "v3_22", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v3_22")))]
    #[doc(alias = "tool")]
    pub fn connect_tool_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_tool_trampoline<F: Fn(&Device) + 'static>(
            this: *mut ffi::GdkDevice,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        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::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "type")]
    pub fn connect_type_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_type_trampoline<F: Fn(&Device) + 'static>(
            this: *mut ffi::GdkDevice,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        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::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

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