gdkx11/auto/

x11_device_xi2.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 glib::{prelude::*, translate::*};
use std::fmt;

glib::wrapper! {
    ///
    ///
    /// ## Properties
    ///
    ///
    /// #### `device-id`
    ///  Readable | Writeable | Construct Only
    /// <details><summary><h4>Device</h4></summary>
    ///
    ///
    /// #### `associated-device`
    ///  Associated pointer or keyboard with this device, if any. Devices of type [`gdk::DeviceType::Master`][crate::gdk::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 [`gdk::DeviceManager`][crate::gdk::DeviceManager] the [`gdk::Device`][crate::gdk::Device] pertains to.
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `display`
    ///  The [`gdk::Display`][crate::gdk::Display] the [`gdk::Device`][crate::gdk::Device] pertains to.
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `has-cursor`
    ///  Whether the device is represented by a cursor on the screen. Devices of type
    /// [`gdk::DeviceType::Master`][crate::gdk::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 [`DeviceExtManual::product_id()`][crate::gdk::prelude::DeviceExtManual::product_id()].
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `seat`
    ///  [`gdk::Seat`][crate::gdk::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 [`DeviceExtManual::vendor_id()`][crate::gdk::prelude::DeviceExtManual::vendor_id()].
    ///
    /// Readable | Writeable | Construct Only
    /// </details>
    ///
    /// # Implements
    ///
    /// [`trait@gdk::prelude::DeviceExt`]
    #[doc(alias = "GdkX11DeviceXI2")]
    pub struct X11DeviceXI2(Object<ffi::GdkX11DeviceXI2, ffi::GdkX11DeviceXI2Class>) @extends gdk::Device;

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

impl X11DeviceXI2 {
    // rustdoc-stripper-ignore-next
    /// Creates a new builder-pattern struct instance to construct [`X11DeviceXI2`] objects.
    ///
    /// This method returns an instance of [`X11DeviceXI2Builder`](crate::builders::X11DeviceXI2Builder) which can be used to create [`X11DeviceXI2`] objects.
    pub fn builder() -> X11DeviceXI2Builder {
        X11DeviceXI2Builder::new()
    }

    #[doc(alias = "device-id")]
    pub fn device_id(&self) -> i32 {
        ObjectExt::property(self, "device-id")
    }
}

// rustdoc-stripper-ignore-next
/// A [builder-pattern] type to construct [`X11DeviceXI2`] objects.
///
/// [builder-pattern]: https://doc.rust-lang.org/1.0.0/style/ownership/builders.html
#[must_use = "The builder must be built to be used"]
pub struct X11DeviceXI2Builder {
    builder: glib::object::ObjectBuilder<'static, X11DeviceXI2>,
}

impl X11DeviceXI2Builder {
    fn new() -> Self {
        Self {
            builder: glib::object::Object::builder(),
        }
    }

    pub fn device_id(self, device_id: i32) -> Self {
        Self {
            builder: self.builder.property("device-id", device_id),
        }
    }

    /// The [`gdk::DeviceManager`][crate::gdk::DeviceManager] the [`gdk::Device`][crate::gdk::Device] pertains to.
    pub fn device_manager(self, device_manager: &impl IsA<gdk::DeviceManager>) -> Self {
        Self {
            builder: self
                .builder
                .property("device-manager", device_manager.clone().upcast()),
        }
    }

    /// The [`gdk::Display`][crate::gdk::Display] the [`gdk::Device`][crate::gdk::Device] pertains to.
    pub fn display(self, display: &impl IsA<gdk::Display>) -> Self {
        Self {
            builder: self.builder.property("display", display.clone().upcast()),
        }
    }

    /// Whether the device is represented by a cursor on the screen. Devices of type
    /// [`gdk::DeviceType::Master`][crate::gdk::DeviceType::Master] will have [`true`] here.
    pub fn has_cursor(self, has_cursor: bool) -> Self {
        Self {
            builder: self.builder.property("has-cursor", has_cursor),
        }
    }

    pub fn input_mode(self, input_mode: gdk::InputMode) -> Self {
        Self {
            builder: self.builder.property("input-mode", input_mode),
        }
    }

    /// Source type for the device.
    pub fn input_source(self, input_source: gdk::InputSource) -> Self {
        Self {
            builder: self.builder.property("input-source", input_source),
        }
    }

    /// The device name.
    pub fn name(self, name: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("name", name.into()),
        }
    }

    /// 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.
    pub fn num_touches(self, num_touches: u32) -> Self {
        Self {
            builder: self.builder.property("num-touches", num_touches),
        }
    }

    /// Product ID of this device, see [`DeviceExtManual::product_id()`][crate::gdk::prelude::DeviceExtManual::product_id()].
    pub fn product_id(self, product_id: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("product-id", product_id.into()),
        }
    }

    /// [`gdk::Seat`][crate::gdk::Seat] of this device.
    pub fn seat(self, seat: &gdk::Seat) -> Self {
        Self {
            builder: self.builder.property("seat", seat.clone()),
        }
    }

    pub fn type_(self, type_: gdk::DeviceType) -> Self {
        Self {
            builder: self.builder.property("type", type_),
        }
    }

    /// Vendor ID of this device, see [`DeviceExtManual::vendor_id()`][crate::gdk::prelude::DeviceExtManual::vendor_id()].
    pub fn vendor_id(self, vendor_id: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("vendor-id", vendor_id.into()),
        }
    }

    // rustdoc-stripper-ignore-next
    /// Build the [`X11DeviceXI2`].
    #[must_use = "Building the object from the builder is usually expensive and is not expected to have side effects"]
    pub fn build(self) -> X11DeviceXI2 {
        self.builder.build()
    }
}

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