saudade 0.4.0

Classic looking retained-mode, cross-platform Rust GUI library
Documentation 
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

mod bevel;
mod button;
mod checkbox;
mod column;
mod container;
mod dialog;
mod dropdown;
mod file_dialog;
mod focus_label;
mod image;
mod label;
mod list;
mod menu;
pub(crate) mod mnemonic;
mod modal;
mod progress_bar;
mod row;
mod scrollbar;
mod slider;
mod text_editor;
mod text_input;

use crate::event::{Event, Key, NamedKey};

/// What focus cycling should do for a Tab-shaped event. Shared by
/// `Container` and `Column`, both of which intercept Tab/Shift+Tab the same
/// way before forwarding events to focused children.
pub(crate) enum TabAction {
    /// `KeyDown(Tab)` — move focus by the given direction (1 = forward,
    /// -1 = backward).
    Cycle(i32),
    /// `Char('\t')` paired with the matching `KeyDown(Tab)` — already
    /// handled, swallow so it doesn't leak into the focused widget.
    Swallow,
}

/// Map an event to the Tab handling it should trigger, or `None` if it's
/// not a tab keystroke at all. We treat the modifier-less `KeyDown(Tab)`
/// as the canonical "move focus" trigger and the trailing `Char('\t')`
/// as a no-op to consume. Modified taps (Ctrl/Alt/Logo+Tab) pass through
/// untouched so the OS / WM can still handle them.
pub(crate) fn tab_action(event: &Event) -> Option<TabAction> {
    match event {
        Event::KeyDown {
            key: Key::Named(NamedKey::Tab),
            modifiers,
        } if !modifiers.control && !modifiers.alt && !modifiers.logo => {
            Some(TabAction::Cycle(if modifiers.shift { -1 } else { 1 }))
        }
        Event::Char {
            ch: '\t',
            modifiers,
        } if !modifiers.control && !modifiers.alt && !modifiers.logo => Some(TabAction::Swallow),
        _ => None,
    }
}

pub use bevel::Bevel;
pub use button::Button;
pub use checkbox::Checkbox;
pub use column::Column;
pub use container::Container;
pub use dialog::{Dialog, DialogIcon};
pub use dropdown::Dropdown;
pub use file_dialog::{FileDialog, FileFilter};
pub use focus_label::FocusLabel;
pub use image::Image;
pub use label::Label;
pub use list::{List, ListIcon, ListItem};
pub use menu::{Menu, MenuBar, MenuItem};
pub use modal::Modal;
pub use progress_bar::ProgressBar;
pub use row::Row;
pub use scrollbar::{Orientation, SCROLLBAR_THICKNESS, ScrollBar};
pub use slider::Slider;
pub use text_editor::TextEditor;
pub use text_input::TextInput;