rust_widgets 2.9.2

Pure Rust cross-platform native GUI library with hardware-adaptive rendering, 180 widgets, touch/gesture support, i18n, and SVG-pipeline-accurate output
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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173

// SPDX-FileCopyrightText: Copyright (c) 2026 Mike Li/Mikewolfli/Wei Li(mikewolfli@163.com)
// SPDX-License-Identifier: MIT

// Hand-maintained const arrays for widget properties.
//
// This header used to claim the file was auto-generated from `properties.rs` with a
// "DO NOT EDIT DIRECTLY" instruction, but no generator exists in `tools/` or
// `scripts/` that writes `.in.rs` files. The only script that touches them
// (`generate_control_route_matrix.py`) *reads* the `create_widgets_*.in.rs` set to
// emit a report, which is a different family. Edit these directly.

macro_rules! impl_properties_base {
    () => {
        pub(crate) const BUTTON_PROPERTIES: &[PropertySchema] = &[
            PropertySchema::new("text", PropertyValueKind::String, true, true),
            PropertySchema::new("pressed", PropertyValueKind::Bool, true, true),
            PropertySchema::new("default", PropertyValueKind::Bool, true, true),
            PropertySchema::new("icon_source", PropertyValueKind::IconSpec, true, true),
            PropertySchema::new("icon_size", PropertyValueKind::UInt, true, true),
            // The shortcut reads as its canonical text and writes as the same spelling; an
            // unset shortcut is `null`.
            PropertySchema::new("shortcut", PropertyValueKind::String, true, true),
            PropertySchema::new("auto_default", PropertyValueKind::Bool, true, true),
            PropertySchema::new("auto_exclusive", PropertyValueKind::Bool, true, true),
            PropertySchema::new("flat", PropertyValueKind::Bool, true, true),
            PropertySchema::enumerated("elide", true, true, &["none", "left", "middle", "right"]),
            PropertySchema::new("drag_enabled", PropertyValueKind::Bool, true, true),
            PropertySchema::new("accepts_drops", PropertyValueKind::Bool, true, true),
            // Held-press repetition: off by default (one press, one activation).
            PropertySchema::new("auto_repeat", PropertyValueKind::Bool, true, true),
            PropertySchema::new("auto_repeat_delay", PropertyValueKind::UInt, true, true),
            PropertySchema::new("auto_repeat_interval", PropertyValueKind::UInt, true, true),
            PropertySchema::new("menu_open", PropertyValueKind::Bool, true, true),
            PropertySchema::new("menu_item_count", PropertyValueKind::UInt, true, false),
            PropertySchema::new("enabled", PropertyValueKind::Bool, true, true),
            PropertySchema::new("tooltip", PropertyValueKind::String, true, true),
            PropertySchema::new("visible", PropertyValueKind::Bool, true, true),
            PropertySchema::new("geometry", PropertyValueKind::String, false, false),
        ];

        pub(crate) const LABEL_PROPERTIES: &[PropertySchema] = &[
            PropertySchema::new("text", PropertyValueKind::String, true, true),
            PropertySchema::enumerated(
                "alignment",
                true,
                true,
                &["left", "centre", "right", "top", "bottom"],
            ),
            PropertySchema::new("word_wrap", PropertyValueKind::Bool, true, true),
            PropertySchema::enumerated("elide", true, true, &["none", "left", "middle", "right"]),
            PropertySchema::new("margin", PropertyValueKind::UInt, true, true),
            PropertySchema::new("scaled_contents", PropertyValueKind::Bool, true, true),
            // Inline links and rich text: opt-in, so plain labels keep their exact pixels.
            PropertySchema::new("indent", PropertyValueKind::UInt, true, true),
            PropertySchema::enumerated("text_format", true, true, &["plain", "rich"]),
            PropertySchema::new("open_external_links", PropertyValueKind::Bool, true, true),
            PropertySchema::new("link_count", PropertyValueKind::UInt, true, false),
            PropertySchema::new("enabled", PropertyValueKind::Bool, true, true),
            PropertySchema::new("visible", PropertyValueKind::Bool, true, true),
            PropertySchema::new("tooltip", PropertyValueKind::String, true, true),
            PropertySchema::new("geometry", PropertyValueKind::String, false, false),
        ];

        pub(crate) const CHECK_BOX_PROPERTIES: &[PropertySchema] = &[
            PropertySchema::new("text", PropertyValueKind::String, true, true),
            // The tokens are the **reader's** vocabulary, not the writer's.
            //
            // This published `off` / `indeterminate` / `on` while `check_state_to_str` returns
            // `unchecked` / `partially_checked` / `checked`. The writer accepts both sets (it
            // parses the aliases deliberately), which is why the write-direction gate stayed
            // green on a genuinely mismatched pair. A consumer that builds a combo box from
            // this list — the designer's first requirement — would offer six values that
            // `get` never reports, and none of them would match the control's current state.
            // `readable_enum_properties_return_a_published_token` is the gate that keeps this
            // list honest in the direction that matters.
            PropertySchema::enumerated(
                "state",
                true,
                true,
                &["unchecked", "partially_checked", "checked"],
            ),
            PropertySchema::new("checked", PropertyValueKind::Bool, true, true),
            PropertySchema::new("tristate_enabled", PropertyValueKind::Bool, true, true),
            PropertySchema::new("auto_exclusive", PropertyValueKind::Bool, true, true),
            PropertySchema::new("auto_repeat", PropertyValueKind::Bool, true, true),
            PropertySchema::new("auto_repeat_delay", PropertyValueKind::UInt, true, true),
            PropertySchema::new("auto_repeat_interval", PropertyValueKind::UInt, true, true),
            PropertySchema::new("enabled", PropertyValueKind::Bool, true, true),
            PropertySchema::new("visible", PropertyValueKind::Bool, true, true),
            PropertySchema::new("tooltip", PropertyValueKind::String, true, true),
            PropertySchema::new("geometry", PropertyValueKind::String, false, false),
        ];

        pub(crate) const RADIO_BUTTON_PROPERTIES: &[PropertySchema] = &[
            PropertySchema::new("text", PropertyValueKind::String, true, true),
            PropertySchema::new("checked", PropertyValueKind::Bool, true, true),
            PropertySchema::new("group_id", PropertyValueKind::String, true, true),
            PropertySchema::new("auto_exclusive", PropertyValueKind::Bool, true, true),
            PropertySchema::new("auto_repeat", PropertyValueKind::Bool, true, true),
            PropertySchema::new("auto_repeat_delay", PropertyValueKind::UInt, true, true),
            PropertySchema::new("auto_repeat_interval", PropertyValueKind::UInt, true, true),
            PropertySchema::new("enabled", PropertyValueKind::Bool, true, true),
            PropertySchema::new("visible", PropertyValueKind::Bool, true, true),
            PropertySchema::new("tooltip", PropertyValueKind::String, true, true),
            PropertySchema::new("geometry", PropertyValueKind::String, false, false),
        ];

        #[cfg(not(alloc_frugal))]
        pub(crate) const TOGGLE_BUTTON_PROPERTIES: &[PropertySchema] = &[
            PropertySchema::new("text", PropertyValueKind::String, true, true),
            PropertySchema::new("checked", PropertyValueKind::Bool, true, true),
            PropertySchema::new("auto_exclusive", PropertyValueKind::Bool, true, true),
            PropertySchema::new("auto_raise", PropertyValueKind::Bool, true, true),
            PropertySchema::new("group_id", PropertyValueKind::String, true, true),
            PropertySchema::new("auto_repeat", PropertyValueKind::Bool, true, true),
            PropertySchema::new("auto_repeat_delay", PropertyValueKind::UInt, true, true),
            PropertySchema::new("auto_repeat_interval", PropertyValueKind::UInt, true, true),
            PropertySchema::new("icon_source", PropertyValueKind::IconSpec, true, true),
            PropertySchema::enumerated(
                "arrow_type",
                true,
                true,
                &["none", "down", "up", "left", "right"],
            ),
            PropertySchema::enumerated(
                "popup_mode",
                true,
                true,
                &["instant", "menu_button", "delayed"],
            ),
            PropertySchema::new("menu_open", PropertyValueKind::Bool, true, true),
            PropertySchema::new("menu_item_count", PropertyValueKind::UInt, true, false),
            // Read-only, and the tokens are the reader's three.
            //
            // `ToggleButton::state()` is **derived** — `disabled` from `enabled`, and
            // `checked`/`normal` from `checked` — so there is no independent state for a writer
            // to set. Declaring it writable (as an earlier revision of this table did) promises
            // a `set` that the control cannot honour, and the write-direction gate rejects the
            // contradiction immediately. Callers change the state through `enabled` and
            // `checked`, which are the two properties it is computed from.
            //
            // The tokens are `normal`/`hover`/`pressed`/`checked`/`disabled` because that is what
            // `get` returns; this row previously published `normal`/`checked`/`disabled` while the
            // reader could also produce `hover` and `pressed` — the two momentary states a pointer
            // drives, which a `state()` read reaches as soon as the control is hovered or held.
            //
            // `state` stays read-only: it is derived from `enabled`, `checked` and the base's
            // hover/press flags, none of which is a `state` write.
            PropertySchema::enumerated(
                "state",
                true,
                false,
                &["normal", "hover", "pressed", "checked", "disabled"],
            ),
            PropertySchema::new("enabled", PropertyValueKind::Bool, true, true),
            PropertySchema::new("visible", PropertyValueKind::Bool, true, true),
            PropertySchema::new("tooltip", PropertyValueKind::String, true, true),
            PropertySchema::new("geometry", PropertyValueKind::String, false, false),
        ];

        pub(crate) const LINE_PROPERTIES: &[PropertySchema] = &[
            PropertySchema::enumerated("orientation", true, true, &["horizontal", "vertical"]),
            PropertySchema::new("thickness", PropertyValueKind::UInt, true, true),
            // The effective line colour: the explicit override when one is set, otherwise the
            // theme/style border colour the painter uses. A `Null` write clears the override.
            PropertySchema::new("color", PropertyValueKind::Color, true, true),
            PropertySchema::new("enabled", PropertyValueKind::Bool, true, true),
            PropertySchema::new("visible", PropertyValueKind::Bool, true, true),
            PropertySchema::new("tooltip", PropertyValueKind::String, true, true),
            PropertySchema::new("geometry", PropertyValueKind::String, false, false),
        ];
    };
}