Struct UiHandle 

pub struct UiHandle { /* private fields */ }

Cloneable remote for mutating the Ui from any thread or task.

Sends are non-blocking; after the App is gone they are no-ops.

Implementations

impl UiHandle

pub fn update(&self, update: impl FnOnce(&mut Ui) + Send + 'static)

Queues a UI mutation to run between rendered frames.

Examples found in repository

examples/tml.rs (line 73)

async fn main() -> io::Result<()> {
	let path = std::env::args()
		.nth(1)
		.unwrap_or_else(|| "example.tml".into());
	let source = std::fs::read_to_string(&path)?;

	let mut ctx = None;
	let mut app = AppOptions::new()
		.quit([Key::Ctrl('c'), Key::Char('q'), Key::Esc])
		.start(|env| {
			let ui = build(&source, env.viewport.width, &env.ctx);
			ctx = Some(env.ctx);
			ui
		})
		.await?;
	let ctx = ctx.expect("start ran the builder");

	let handle = app.handle();
	tokio::spawn(async move {
		let mut seen = modified(path.as_ref());
		loop {
			tokio::time::sleep(Duration::from_millis(150)).await;
			let stamp = modified(path.as_ref());
			if stamp == seen {
				continue;
			}
			seen = stamp;
			let Ok(source) = std::fs::read_to_string(&path) else {
				continue;
			};
			let ctx = ctx.clone();
			handle.update(move |ui| *ui = build(&source, ui.frame().size().width, &ctx));
		}
	});

	while app.next().await?.is_some() {}
	Ok(())
}

pub fn set_text(&self, id: impl Into<Str>, text: impl Into<Str>)

Queues replacement text for the component named by id.

pub fn invalidate(&self, id: impl Into<Str>)

Queues invalidation of the component named by id.

pub fn shutdown(&self)

Requests shutdown of the application host.

Trait Implementations

impl Clone for UiHandle

fn clone(&self) -> UiHandle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.