Struct cursive_extras::LoadingAnimation

pub struct LoadingAnimation<T: Send + Sync + 'static> { /* private fields */ }

Simple loading animation view that runs a task in a background thread and shows a loading animation and message while it completes and allows for retrieval of a return value

Example

let mut root = cursive::default();
let anim = LoadingAnimation::new("Loading Dummy Resource...", || {
    thread::sleep(Duration::from_secs(10));
});
 
root.add_layer(Dialog::around(anim.with_name("loader")).title("Loading..."));
root.set_fps(30);
root.set_global_callback(Event::Refresh, |view| {
    let mut loader = view.find_name::<LoadingAnimation<()>>("loader").unwrap();
    if loader.is_done() {
        loader.finish().unwrap_or(());
        view.quit()
    }
});
root.run();

Implementations

impl<T: Send + Sync> LoadingAnimation<T>

pub fn new<U>(message: &str, task: U) -> LoadingAnimation<T> where
    U: FnOnce() -> T + Send + Sync + 'static, 

Create a new LoadingAnimation with the specified closure or function pointer as the task

pub fn is_done(&mut self) -> bool

Has the background task finished executing?

pub fn finish(&mut self) -> Option<T>

Join with the task’s thread, block until it is finished, and return the resulting value

It is best to run this when LoadingAnimation::is_done() is true

This will return None if called more than once

Panics

This method will panic if the underlying task panicked while executing

Trait Implementations

impl<T: Clone + Send + Sync + 'static> Clone for LoadingAnimation<T>

fn clone(&self) -> LoadingAnimation<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Send + Sync> View for LoadingAnimation<T>

fn draw(&self, printer: &Printer<'_, '_>)

Draws the view with the given printer (includes bounds) and focus.

fn on_event(&mut self, event: Event) -> EventResult

Called when an event is received (key press, mouse event, …).

fn required_size(&mut self, _: Vec2) -> Vec2

Returns the minimum size the view requires with the given restrictions.

fn layout(&mut self, XY<usize>)

Called once the size for this view has been decided.

fn needs_relayout(&self) -> bool

Should return true if the view content changed since the last call to layout().

fn call_on_any(
    &mut self,
    &Selector<'_>,
    &'a mut (dyn FnMut(&mut (dyn View + 'static)) + 'a)
)

Runs a closure on the view identified by the given selector.

fn focus_view(&mut self, &Selector<'_>) -> Result<EventResult, ViewNotFound>

Moves the focus to the view identified by the given selector.

fn take_focus(&mut self, source: Direction) -> Result<EventResult, CannotFocus>

Attempt to give this view the focus.

fn important_area(&self, view_size: XY<usize>) -> Rect

What part of the view is important and should be visible?

fn type_name(&self) -> &'static str

Returns the type of this view.