pub struct App { /* private fields */ }Expand description
User-facing SUI application builder.
App is the recommended entrypoint for Rust applications. It keeps the
public surface small while still producing the same runtime used by lower
level integration and debug tools. The builder is intentionally owned and
value-oriented: construct it on any thread, register resources up front,
add windows, then build or run it on the UI thread.
Implementations§
Source§impl App
impl App
Sourcepub fn new() -> Self
pub fn new() -> Self
Create an empty application with SUI’s built-in widget resources already registered.
Examples found in repository?
More examples
3fn main() -> Result<()> {
4 let theme = DefaultTheme::light();
5
6 let content = Stack::vertical()
7 .gap(12.0)
8 .alignment(Alignment::Start)
9 .with_child(
10 Label::new("Your first SUI window")
11 .theme(theme)
12 .font_size(24.0)
13 .line_height(30.0)
14 .color(theme.palette.text),
15 )
16 .with_child(
17 Label::new("Widgets are retained Rust values arranged into one tree.")
18 .theme(theme)
19 .color(theme.palette.text_muted),
20 )
21 .with_child(
22 Button::new("Say hello")
23 .theme(theme)
24 .on_press(|| println!("Hello from SUI!")),
25 );
26
27 let root = Surface::window(content)
28 .theme(theme)
29 .padding(Insets::all(24.0))
30 .fill();
31
32 App::new()
33 .window(Window::new("SUI Quickstart").root(root))
34 .run()
35}3fn main() -> Result<()> {
4 let theme = DefaultTheme::dark();
5 let document = RichDocumentModel::from_markdown(
6 r#"# Deployment report
7
8SUI keeps this document selectable across blocks. Follow the [runbook](https://example.test/runbook) for details.
9
10- [x] Build artifacts
11- [x] Run tests
12- [ ] Publish release
13
14```rust
15let status = deploy().await?;
16assert!(status.ready());
17```
18"#,
19 );
20
21 let mut operation = RichExtensionBlock::new("operation-log", "Release operation");
22 operation.status = RichDocumentStatus::Running;
23 operation.summary = Some("2 of 3 stages complete".into());
24 operation.body = "build complete\ntest complete\npublish running".into();
25 document.append_extension(operation);
26
27 let view = RichDocumentView::new(document)
28 .theme(theme)
29 .on_link(|destination| println!("Application URL policy received: {destination}"));
30 let root = Surface::window(ScrollView::vertical(view).retain_content_layer())
31 .theme(theme)
32 .padding(Insets::all(24.0))
33 .fill();
34
35 App::new()
36 .window(Window::new("SUI Rich Document").root(root))
37 .run()
38}6fn main() -> Result<()> {
7 let worker_status = Signal::named(
8 "worker_status",
9 "Waiting for the background worker…".to_string(),
10 );
11 let application_status = Signal::named(
12 "application_status",
13 "No application multicast received yet.".to_string(),
14 );
15 let window_status = Signal::named(
16 "window_status",
17 "No window multicast received yet.".to_string(),
18 );
19
20 let worker_handler = worker_status.clone();
21 let application_handler = application_status.clone();
22 let window_handler = window_status.clone();
23 let root = Padding::all(
24 24.0,
25 Stack::vertical()
26 .gap(12.0)
27 .alignment(Alignment::Stretch)
28 .with_child(Label::new("Typed commands"))
29 .with_child(Label::new("").text_from(worker_status))
30 .with_child(Label::new("").text_from(application_status))
31 .with_child(Label::new("").text_from(window_status))
32 .with_child(
33 Button::new("Broadcast announcement").on_press_with_ctx(|ctx| {
34 ctx.command_sender().broadcast_application(
35 ANNOUNCEMENT,
36 "Hello from a widget callback".to_string(),
37 );
38 }),
39 ),
40 );
41
42 App::new()
43 .on_command(WORK_FINISHED, move |ctx, message| {
44 worker_handler.set(format!("Worker result: {message}"));
45 ctx.set_handled();
46 })
47 .on_command(ANNOUNCEMENT, move |_, message| {
48 application_handler.set(format!("Application received: {message}"));
49 })
50 .window(
51 Window::new("Commands")
52 .on_command(ANNOUNCEMENT, move |_, message| {
53 window_handler.set(format!("Window received: {message}"));
54 })
55 .root(root),
56 )
57 .run_with_handle(|ui| {
58 std::thread::spawn(move || {
59 // Replace this with blocking I/O or CPU work.
60 ui.send_application(WORK_FINISHED, "loaded".to_string());
61 });
62 })
63}69fn main() -> Result<()> {
70 let theme = DefaultTheme::dark();
71 let state = Rc::new(RefCell::new(FormState::default()));
72
73 let name_state = Rc::clone(&state);
74 let name = TextInput::new("Display name")
75 .placeholder("Ada Lovelace")
76 .min_width(360.0)
77 .theme(theme)
78 .on_change_with_ctx(move |ctx, value| {
79 name_state.borrow_mut().name = value;
80 refresh_window(ctx);
81 });
82
83 let password_state = Rc::clone(&state);
84 let password = PasswordInput::new("Password")
85 .placeholder("At least eight characters")
86 .min_width(360.0)
87 .theme(theme)
88 .on_change_with_ctx(move |ctx, value| {
89 password_state.borrow_mut().password = value;
90 refresh_window(ctx);
91 });
92
93 let initial_schedule = state.borrow().scheduled_for.clone();
94 let schedule_state = Rc::clone(&state);
95 let scheduled_for = DateTimeInput::new("Scheduled for")
96 .value(initial_schedule)
97 .min_width(360.0)
98 .theme(theme)
99 .on_change_with_ctx(move |ctx, value| {
100 schedule_state.borrow_mut().scheduled_for = value;
101 refresh_window(ctx);
102 });
103
104 let status_state = Rc::clone(&state);
105 let status = Label::new("Draft")
106 .text_when(move || status_state.borrow().status())
107 .theme(theme)
108 .color(theme.palette.text_muted);
109
110 let enabled_state = Rc::clone(&state);
111 let submit_state = Rc::clone(&state);
112 let submit = Button::new("Save profile")
113 .theme(theme)
114 .enabled_when(move || enabled_state.borrow().can_submit())
115 .on_press_with_ctx(move |ctx| {
116 submit_state.borrow_mut().submissions += 1;
117 refresh_window(ctx);
118 });
119
120 let form = Stack::vertical()
121 .gap(12.0)
122 .alignment(Alignment::Start)
123 .with_child(
124 Label::new("Create a profile")
125 .theme(theme)
126 .font_size(26.0)
127 .line_height(32.0)
128 .color(theme.palette.text),
129 )
130 .with_child(
131 Label::new("Enter a name, password, and local appointment time.")
132 .theme(theme)
133 .color(theme.palette.text_muted),
134 )
135 .with_child(name)
136 .with_child(password)
137 .with_child(scheduled_for)
138 .with_child(submit)
139 .with_child(status);
140
141 let card = Surface::panel(form).theme(theme).padding(Insets::all(20.0));
142 let root = Surface::window(card)
143 .theme(theme)
144 .padding(Insets::all(24.0))
145 .fill();
146
147 App::new()
148 .window(Window::new("Stateful SUI Form").root(root))
149 .run()
150}Sourcepub fn window(self, window: Window) -> Self
pub fn window(self, window: Window) -> Self
Add a window to the application.
Examples found in repository?
3fn main() -> Result<()> {
4 let theme = DefaultTheme::light();
5
6 let content = Stack::vertical()
7 .gap(12.0)
8 .alignment(Alignment::Start)
9 .with_child(
10 Label::new("Your first SUI window")
11 .theme(theme)
12 .font_size(24.0)
13 .line_height(30.0)
14 .color(theme.palette.text),
15 )
16 .with_child(
17 Label::new("Widgets are retained Rust values arranged into one tree.")
18 .theme(theme)
19 .color(theme.palette.text_muted),
20 )
21 .with_child(
22 Button::new("Say hello")
23 .theme(theme)
24 .on_press(|| println!("Hello from SUI!")),
25 );
26
27 let root = Surface::window(content)
28 .theme(theme)
29 .padding(Insets::all(24.0))
30 .fill();
31
32 App::new()
33 .window(Window::new("SUI Quickstart").root(root))
34 .run()
35}More examples
3fn main() -> Result<()> {
4 let theme = DefaultTheme::dark();
5 let document = RichDocumentModel::from_markdown(
6 r#"# Deployment report
7
8SUI keeps this document selectable across blocks. Follow the [runbook](https://example.test/runbook) for details.
9
10- [x] Build artifacts
11- [x] Run tests
12- [ ] Publish release
13
14```rust
15let status = deploy().await?;
16assert!(status.ready());
17```
18"#,
19 );
20
21 let mut operation = RichExtensionBlock::new("operation-log", "Release operation");
22 operation.status = RichDocumentStatus::Running;
23 operation.summary = Some("2 of 3 stages complete".into());
24 operation.body = "build complete\ntest complete\npublish running".into();
25 document.append_extension(operation);
26
27 let view = RichDocumentView::new(document)
28 .theme(theme)
29 .on_link(|destination| println!("Application URL policy received: {destination}"));
30 let root = Surface::window(ScrollView::vertical(view).retain_content_layer())
31 .theme(theme)
32 .padding(Insets::all(24.0))
33 .fill();
34
35 App::new()
36 .window(Window::new("SUI Rich Document").root(root))
37 .run()
38}6fn main() -> Result<()> {
7 let worker_status = Signal::named(
8 "worker_status",
9 "Waiting for the background worker…".to_string(),
10 );
11 let application_status = Signal::named(
12 "application_status",
13 "No application multicast received yet.".to_string(),
14 );
15 let window_status = Signal::named(
16 "window_status",
17 "No window multicast received yet.".to_string(),
18 );
19
20 let worker_handler = worker_status.clone();
21 let application_handler = application_status.clone();
22 let window_handler = window_status.clone();
23 let root = Padding::all(
24 24.0,
25 Stack::vertical()
26 .gap(12.0)
27 .alignment(Alignment::Stretch)
28 .with_child(Label::new("Typed commands"))
29 .with_child(Label::new("").text_from(worker_status))
30 .with_child(Label::new("").text_from(application_status))
31 .with_child(Label::new("").text_from(window_status))
32 .with_child(
33 Button::new("Broadcast announcement").on_press_with_ctx(|ctx| {
34 ctx.command_sender().broadcast_application(
35 ANNOUNCEMENT,
36 "Hello from a widget callback".to_string(),
37 );
38 }),
39 ),
40 );
41
42 App::new()
43 .on_command(WORK_FINISHED, move |ctx, message| {
44 worker_handler.set(format!("Worker result: {message}"));
45 ctx.set_handled();
46 })
47 .on_command(ANNOUNCEMENT, move |_, message| {
48 application_handler.set(format!("Application received: {message}"));
49 })
50 .window(
51 Window::new("Commands")
52 .on_command(ANNOUNCEMENT, move |_, message| {
53 window_handler.set(format!("Window received: {message}"));
54 })
55 .root(root),
56 )
57 .run_with_handle(|ui| {
58 std::thread::spawn(move || {
59 // Replace this with blocking I/O or CPU work.
60 ui.send_application(WORK_FINISHED, "loaded".to_string());
61 });
62 })
63}69fn main() -> Result<()> {
70 let theme = DefaultTheme::dark();
71 let state = Rc::new(RefCell::new(FormState::default()));
72
73 let name_state = Rc::clone(&state);
74 let name = TextInput::new("Display name")
75 .placeholder("Ada Lovelace")
76 .min_width(360.0)
77 .theme(theme)
78 .on_change_with_ctx(move |ctx, value| {
79 name_state.borrow_mut().name = value;
80 refresh_window(ctx);
81 });
82
83 let password_state = Rc::clone(&state);
84 let password = PasswordInput::new("Password")
85 .placeholder("At least eight characters")
86 .min_width(360.0)
87 .theme(theme)
88 .on_change_with_ctx(move |ctx, value| {
89 password_state.borrow_mut().password = value;
90 refresh_window(ctx);
91 });
92
93 let initial_schedule = state.borrow().scheduled_for.clone();
94 let schedule_state = Rc::clone(&state);
95 let scheduled_for = DateTimeInput::new("Scheduled for")
96 .value(initial_schedule)
97 .min_width(360.0)
98 .theme(theme)
99 .on_change_with_ctx(move |ctx, value| {
100 schedule_state.borrow_mut().scheduled_for = value;
101 refresh_window(ctx);
102 });
103
104 let status_state = Rc::clone(&state);
105 let status = Label::new("Draft")
106 .text_when(move || status_state.borrow().status())
107 .theme(theme)
108 .color(theme.palette.text_muted);
109
110 let enabled_state = Rc::clone(&state);
111 let submit_state = Rc::clone(&state);
112 let submit = Button::new("Save profile")
113 .theme(theme)
114 .enabled_when(move || enabled_state.borrow().can_submit())
115 .on_press_with_ctx(move |ctx| {
116 submit_state.borrow_mut().submissions += 1;
117 refresh_window(ctx);
118 });
119
120 let form = Stack::vertical()
121 .gap(12.0)
122 .alignment(Alignment::Start)
123 .with_child(
124 Label::new("Create a profile")
125 .theme(theme)
126 .font_size(26.0)
127 .line_height(32.0)
128 .color(theme.palette.text),
129 )
130 .with_child(
131 Label::new("Enter a name, password, and local appointment time.")
132 .theme(theme)
133 .color(theme.palette.text_muted),
134 )
135 .with_child(name)
136 .with_child(password)
137 .with_child(scheduled_for)
138 .with_child(submit)
139 .with_child(status);
140
141 let card = Surface::panel(form).theme(theme).padding(Insets::all(20.0));
142 let root = Surface::window(card)
143 .theme(theme)
144 .padding(Insets::all(24.0))
145 .fill();
146
147 App::new()
148 .window(Window::new("Stateful SUI Form").root(root))
149 .run()
150}Sourcepub fn controller(self, controller: impl CommandController + 'static) -> Self
pub fn controller(self, controller: impl CommandController + 'static) -> Self
Attach an application-scoped service outside the widget tree.
Sourcepub fn url_policy(self, policy: UrlPolicy) -> Self
pub fn url_policy(self, policy: UrlPolicy) -> Self
Decide which URLs EventCtx::open_url hands to the platform, in place
of the default that opens only http, https, and mailto URLs. See
UrlPolicy.
Sourcepub fn on_command<T, F>(self, key: CommandKey<T>, handler: F) -> Self
pub fn on_command<T, F>(self, key: CommandKey<T>, handler: F) -> Self
Subscribe an application-scoped typed command handler.
Examples found in repository?
6fn main() -> Result<()> {
7 let worker_status = Signal::named(
8 "worker_status",
9 "Waiting for the background worker…".to_string(),
10 );
11 let application_status = Signal::named(
12 "application_status",
13 "No application multicast received yet.".to_string(),
14 );
15 let window_status = Signal::named(
16 "window_status",
17 "No window multicast received yet.".to_string(),
18 );
19
20 let worker_handler = worker_status.clone();
21 let application_handler = application_status.clone();
22 let window_handler = window_status.clone();
23 let root = Padding::all(
24 24.0,
25 Stack::vertical()
26 .gap(12.0)
27 .alignment(Alignment::Stretch)
28 .with_child(Label::new("Typed commands"))
29 .with_child(Label::new("").text_from(worker_status))
30 .with_child(Label::new("").text_from(application_status))
31 .with_child(Label::new("").text_from(window_status))
32 .with_child(
33 Button::new("Broadcast announcement").on_press_with_ctx(|ctx| {
34 ctx.command_sender().broadcast_application(
35 ANNOUNCEMENT,
36 "Hello from a widget callback".to_string(),
37 );
38 }),
39 ),
40 );
41
42 App::new()
43 .on_command(WORK_FINISHED, move |ctx, message| {
44 worker_handler.set(format!("Worker result: {message}"));
45 ctx.set_handled();
46 })
47 .on_command(ANNOUNCEMENT, move |_, message| {
48 application_handler.set(format!("Application received: {message}"));
49 })
50 .window(
51 Window::new("Commands")
52 .on_command(ANNOUNCEMENT, move |_, message| {
53 window_handler.set(format!("Window received: {message}"));
54 })
55 .root(root),
56 )
57 .run_with_handle(|ui| {
58 std::thread::spawn(move || {
59 // Replace this with blocking I/O or CPU work.
60 ui.send_application(WORK_FINISHED, "loaded".to_string());
61 });
62 })
63}Sourcepub fn main_window<W>(self, title: impl Into<String>, root: W) -> Selfwhere
W: Widget + 'static,
pub fn main_window<W>(self, title: impl Into<String>, root: W) -> Selfwhere
W: Widget + 'static,
Add a window by title and root widget.
Sourcepub fn resources(&mut self) -> ResourceRegistry<'_>
pub fn resources(&mut self) -> ResourceRegistry<'_>
Mutably access the application’s resource registry.
Sourcepub fn with_resources(
self,
configure: impl FnOnce(&mut ResourceRegistry<'_>) -> Result<()>,
) -> Result<Self>
pub fn with_resources( self, configure: impl FnOnce(&mut ResourceRegistry<'_>) -> Result<()>, ) -> Result<Self>
Configure resources while preserving builder-style application setup.
Sourcepub fn render_options(self, options: WindowRenderOptions) -> Self
pub fn render_options(self, options: WindowRenderOptions) -> Self
Set initial render options for every window when the app starts.
Sourcepub fn feathering(self, enabled: bool) -> Self
pub fn feathering(self, enabled: bool) -> Self
Configure renderer feathering when the WGPU renderer is enabled.
Sourcepub fn feather_width(self, width: f32) -> Self
pub fn feather_width(self, width: f32) -> Self
Configure renderer feather width when the WGPU renderer is enabled.
Sourcepub fn external_texture_registry(
self,
registry: WgpuExternalTextureRegistry,
) -> Self
pub fn external_texture_registry( self, registry: WgpuExternalTextureRegistry, ) -> Self
Attach a shared registry for app-owned WGPU textures rendered through SUI’s normal image composition path.
Sourcepub fn configured_external_texture_registry(
&self,
) -> Option<&WgpuExternalTextureRegistry>
pub fn configured_external_texture_registry( &self, ) -> Option<&WgpuExternalTextureRegistry>
Return the configured app-owned texture registry, if one is attached.
Sourcepub fn build(self) -> Result<Runtime>
pub fn build(self) -> Result<Runtime>
Build the runtime without starting a platform event loop.
This is the right entrypoint for tests, headless rendering, embedding, and custom platform integrations.
Sourcepub fn run(self) -> Result<()>
pub fn run(self) -> Result<()>
Run the app on the default desktop/web platform event loop.
Examples found in repository?
More examples
3fn main() -> Result<()> {
4 let theme = DefaultTheme::light();
5
6 let content = Stack::vertical()
7 .gap(12.0)
8 .alignment(Alignment::Start)
9 .with_child(
10 Label::new("Your first SUI window")
11 .theme(theme)
12 .font_size(24.0)
13 .line_height(30.0)
14 .color(theme.palette.text),
15 )
16 .with_child(
17 Label::new("Widgets are retained Rust values arranged into one tree.")
18 .theme(theme)
19 .color(theme.palette.text_muted),
20 )
21 .with_child(
22 Button::new("Say hello")
23 .theme(theme)
24 .on_press(|| println!("Hello from SUI!")),
25 );
26
27 let root = Surface::window(content)
28 .theme(theme)
29 .padding(Insets::all(24.0))
30 .fill();
31
32 App::new()
33 .window(Window::new("SUI Quickstart").root(root))
34 .run()
35}3fn main() -> Result<()> {
4 let theme = DefaultTheme::dark();
5 let document = RichDocumentModel::from_markdown(
6 r#"# Deployment report
7
8SUI keeps this document selectable across blocks. Follow the [runbook](https://example.test/runbook) for details.
9
10- [x] Build artifacts
11- [x] Run tests
12- [ ] Publish release
13
14```rust
15let status = deploy().await?;
16assert!(status.ready());
17```
18"#,
19 );
20
21 let mut operation = RichExtensionBlock::new("operation-log", "Release operation");
22 operation.status = RichDocumentStatus::Running;
23 operation.summary = Some("2 of 3 stages complete".into());
24 operation.body = "build complete\ntest complete\npublish running".into();
25 document.append_extension(operation);
26
27 let view = RichDocumentView::new(document)
28 .theme(theme)
29 .on_link(|destination| println!("Application URL policy received: {destination}"));
30 let root = Surface::window(ScrollView::vertical(view).retain_content_layer())
31 .theme(theme)
32 .padding(Insets::all(24.0))
33 .fill();
34
35 App::new()
36 .window(Window::new("SUI Rich Document").root(root))
37 .run()
38}69fn main() -> Result<()> {
70 let theme = DefaultTheme::dark();
71 let state = Rc::new(RefCell::new(FormState::default()));
72
73 let name_state = Rc::clone(&state);
74 let name = TextInput::new("Display name")
75 .placeholder("Ada Lovelace")
76 .min_width(360.0)
77 .theme(theme)
78 .on_change_with_ctx(move |ctx, value| {
79 name_state.borrow_mut().name = value;
80 refresh_window(ctx);
81 });
82
83 let password_state = Rc::clone(&state);
84 let password = PasswordInput::new("Password")
85 .placeholder("At least eight characters")
86 .min_width(360.0)
87 .theme(theme)
88 .on_change_with_ctx(move |ctx, value| {
89 password_state.borrow_mut().password = value;
90 refresh_window(ctx);
91 });
92
93 let initial_schedule = state.borrow().scheduled_for.clone();
94 let schedule_state = Rc::clone(&state);
95 let scheduled_for = DateTimeInput::new("Scheduled for")
96 .value(initial_schedule)
97 .min_width(360.0)
98 .theme(theme)
99 .on_change_with_ctx(move |ctx, value| {
100 schedule_state.borrow_mut().scheduled_for = value;
101 refresh_window(ctx);
102 });
103
104 let status_state = Rc::clone(&state);
105 let status = Label::new("Draft")
106 .text_when(move || status_state.borrow().status())
107 .theme(theme)
108 .color(theme.palette.text_muted);
109
110 let enabled_state = Rc::clone(&state);
111 let submit_state = Rc::clone(&state);
112 let submit = Button::new("Save profile")
113 .theme(theme)
114 .enabled_when(move || enabled_state.borrow().can_submit())
115 .on_press_with_ctx(move |ctx| {
116 submit_state.borrow_mut().submissions += 1;
117 refresh_window(ctx);
118 });
119
120 let form = Stack::vertical()
121 .gap(12.0)
122 .alignment(Alignment::Start)
123 .with_child(
124 Label::new("Create a profile")
125 .theme(theme)
126 .font_size(26.0)
127 .line_height(32.0)
128 .color(theme.palette.text),
129 )
130 .with_child(
131 Label::new("Enter a name, password, and local appointment time.")
132 .theme(theme)
133 .color(theme.palette.text_muted),
134 )
135 .with_child(name)
136 .with_child(password)
137 .with_child(scheduled_for)
138 .with_child(submit)
139 .with_child(status);
140
141 let card = Surface::panel(form).theme(theme).padding(Insets::all(20.0));
142 let root = Surface::window(card)
143 .theme(theme)
144 .padding(Insets::all(24.0))
145 .fill();
146
147 App::new()
148 .window(Window::new("Stateful SUI Form").root(root))
149 .run()
150}Sourcepub fn run_with_platform(self, platform: DesktopPlatform) -> Result<()>
pub fn run_with_platform(self, platform: DesktopPlatform) -> Result<()>
Run the app with a configured desktop platform host.
Optional native-surface libraries use this to attach platform extensions while preserving the renderer configuration stored in this application builder.
Sourcepub fn run_with_handle(self, on_ready: impl FnOnce(UiHandle)) -> Result<()>
pub fn run_with_handle(self, on_ready: impl FnOnce(UiHandle)) -> Result<()>
Run the app and receive a cloneable, thread-safe command handle once the event loop is ready.
Background tasks normally send typed window/application commands. A bare
UiHandle::wake only schedules controller wake hooks and never creates
a widget event.
Examples found in repository?
6fn main() -> Result<()> {
7 let worker_status = Signal::named(
8 "worker_status",
9 "Waiting for the background worker…".to_string(),
10 );
11 let application_status = Signal::named(
12 "application_status",
13 "No application multicast received yet.".to_string(),
14 );
15 let window_status = Signal::named(
16 "window_status",
17 "No window multicast received yet.".to_string(),
18 );
19
20 let worker_handler = worker_status.clone();
21 let application_handler = application_status.clone();
22 let window_handler = window_status.clone();
23 let root = Padding::all(
24 24.0,
25 Stack::vertical()
26 .gap(12.0)
27 .alignment(Alignment::Stretch)
28 .with_child(Label::new("Typed commands"))
29 .with_child(Label::new("").text_from(worker_status))
30 .with_child(Label::new("").text_from(application_status))
31 .with_child(Label::new("").text_from(window_status))
32 .with_child(
33 Button::new("Broadcast announcement").on_press_with_ctx(|ctx| {
34 ctx.command_sender().broadcast_application(
35 ANNOUNCEMENT,
36 "Hello from a widget callback".to_string(),
37 );
38 }),
39 ),
40 );
41
42 App::new()
43 .on_command(WORK_FINISHED, move |ctx, message| {
44 worker_handler.set(format!("Worker result: {message}"));
45 ctx.set_handled();
46 })
47 .on_command(ANNOUNCEMENT, move |_, message| {
48 application_handler.set(format!("Application received: {message}"));
49 })
50 .window(
51 Window::new("Commands")
52 .on_command(ANNOUNCEMENT, move |_, message| {
53 window_handler.set(format!("Window received: {message}"));
54 })
55 .root(root),
56 )
57 .run_with_handle(|ui| {
58 std::thread::spawn(move || {
59 // Replace this with blocking I/O or CPU work.
60 ui.send_application(WORK_FINISHED, "loaded".to_string());
61 });
62 })
63}Sourcepub fn start_pumped_with_handle(
self,
on_ready: impl FnOnce(UiHandle),
) -> Result<PumpedDesktop>
pub fn start_pumped_with_handle( self, on_ready: impl FnOnce(UiHandle), ) -> Result<PumpedDesktop>
Start the app on the desktop without blocking and receive a UI command handle once its event loop is ready.
The caller drives the event loop by calling
PumpedDesktop::pump repeatedly, which
lets another framework’s event loop, such as a JavaScript runtime’s,
own the main thread.
Sourcepub fn run_with_platform_and_handle(
self,
platform: DesktopPlatform,
on_ready: impl FnOnce(UiHandle),
) -> Result<()>
pub fn run_with_platform_and_handle( self, platform: DesktopPlatform, on_ready: impl FnOnce(UiHandle), ) -> Result<()>
Run with a configured platform host and receive a UI command handle once its event loop is ready.
Sourcepub fn into_application(self) -> Application
pub fn into_application(self) -> Application
Convert back to the lower-level application builder.
This is intended for debug tooling and migration code. Regular demos and
applications should prefer App methods directly.
Trait Implementations§
Auto Trait Implementations§
impl !RefUnwindSafe for App
impl !Send for App
impl !Sync for App
impl !UnwindSafe for App
impl Forget for App
impl Freeze for App
impl Move for App
impl Unpin for App
impl UnsafeUnpin for App
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
Source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can
then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.Source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be
further downcast into Rc<ConcreteType> where ConcreteType implements Trait.Source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &Any’s vtable from &Trait’s.Source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &mut Any’s vtable from &mut Trait’s.