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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

// Take a look at the license at the top of the repository in the LICENSE file.

use std::{fmt, mem};

use glib::translate::*;

use crate::{EventType, Key, KeyEvent, KeyMatch, ModifierType};

define_event! {
    KeyEvent,
    ffi::GdkKeyEvent,
    &[EventType::KeyPress, EventType::KeyRelease]
}

impl KeyEvent {
    /// Extracts the keyval from a key event.
    ///
    /// # Returns
    ///
    /// the keyval of @self
    #[doc(alias = "gdk_key_event_get_keyval")]
    #[doc(alias = "get_keyval")]
    pub fn keyval(&self) -> Key {
        unsafe { from_glib(ffi::gdk_key_event_get_keyval(self.to_glib_none().0)) }
    }

    /// Gets a keyval and modifier combination that will match
    /// the event.
    ///
    /// See [`matches()`][Self::matches()].
    ///
    /// # Returns
    ///
    /// [`true`] on success
    ///
    /// ## `keyval`
    /// return location for a keyval
    ///
    /// ## `modifiers`
    /// return location for modifiers
    #[doc(alias = "gdk_key_event_get_match")]
    #[doc(alias = "get_match")]
    pub fn match_(&self) -> Option<(Key, ModifierType)> {
        unsafe {
            let mut keyval = mem::MaybeUninit::uninit();
            let mut modifiers = mem::MaybeUninit::uninit();
            let ret = from_glib(ffi::gdk_key_event_get_match(
                self.to_glib_none().0,
                keyval.as_mut_ptr(),
                modifiers.as_mut_ptr(),
            ));
            if ret {
                let keyval = keyval.assume_init();
                let modifiers = modifiers.assume_init();
                Some((from_glib(keyval), from_glib(modifiers)))
            } else {
                None
            }
        }
    }

    /// Matches a key event against a keyval and modifiers.
    ///
    /// This is typically used to trigger keyboard shortcuts such as Ctrl-C.
    ///
    /// Partial matches are possible where the combination matches
    /// if the currently active group is ignored.
    ///
    /// Note that we ignore Caps Lock for matching.
    /// ## `keyval`
    /// the keyval to match
    /// ## `modifiers`
    /// the modifiers to match
    ///
    /// # Returns
    ///
    /// a [`KeyMatch`][crate::KeyMatch] value describing whether @self matches
    #[doc(alias = "gdk_key_event_matches")]
    pub fn matches(&self, keyval: Key, modifiers: ModifierType) -> KeyMatch {
        unsafe {
            from_glib(ffi::gdk_key_event_matches(
                self.to_glib_none().0,
                keyval.into_glib(),
                modifiers.into_glib(),
            ))
        }
    }
}

impl fmt::Debug for KeyEvent {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        f.debug_struct("KeyEvent")
            .field("consumed_modifiers", &self.consumed_modifiers())
            .field("keycode", &self.keycode())
            .field("keyval", &self.keyval())
            .field("layout", &self.layout())
            .field("level", &self.level())
            .field("match", &self.match_())
            .field("is_modifier", &self.is_modifier())
            .finish()
    }
}