1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
// 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::Component;
use crate::Object;
use glib::object::Cast;
use glib::object::IsA;
use glib::translate::*;
use std::fmt;

glib::wrapper! {
    /// Toplevel for embedding into other processes
    ///
    /// See [class[`Socket`][crate::Socket]]
    ///
    /// # Implements
    ///
    /// [`AtkPlugExt`][trait@crate::prelude::AtkPlugExt], [`AtkObjectExt`][trait@crate::prelude::AtkObjectExt], [`trait@glib::ObjectExt`], [`ComponentExt`][trait@crate::prelude::ComponentExt]
    #[doc(alias = "AtkPlug")]
    pub struct Plug(Object<ffi::AtkPlug, ffi::AtkPlugClass>) @extends Object, @implements Component;

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

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

    /// Creates a new [`Plug`][crate::Plug] instance.
    ///
    /// # Returns
    ///
    /// the newly created [`Plug`][crate::Plug]
    #[doc(alias = "atk_plug_new")]
    pub fn new() -> Plug {
        assert_initialized_main_thread!();
        unsafe { Object::from_glib_full(ffi::atk_plug_new()).unsafe_cast() }
    }
}

impl Default for Plug {
    fn default() -> Self {
        Self::new()
    }
}

/// Trait containing all [`struct@Plug`] methods.
///
/// # Implementors
///
/// [`Plug`][struct@crate::Plug]
pub trait AtkPlugExt: 'static {
    /// Gets the unique ID of an [`Plug`][crate::Plug] object, which can be used to
    /// embed inside of an [`Socket`][crate::Socket] using [`AtkSocketExt::embed()`][crate::prelude::AtkSocketExt::embed()].
    ///
    /// Internally, this calls a class function that should be registered
    /// by the IPC layer (usually at-spi2-atk). The implementor of an
    /// [`Plug`][crate::Plug] object should call this function (after atk-bridge is
    /// loaded) and pass the value to the process implementing the
    /// [`Socket`][crate::Socket], so it could embed the plug.
    ///
    /// # Returns
    ///
    /// the unique ID for the plug
    #[doc(alias = "atk_plug_get_id")]
    #[doc(alias = "get_id")]
    fn id(&self) -> Option<glib::GString>;
}

impl<O: IsA<Plug>> AtkPlugExt for O {
    fn id(&self) -> Option<glib::GString> {
        unsafe { from_glib_full(ffi::atk_plug_get_id(self.as_ref().to_glib_none().0)) }
    }
}

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