Struct Saves 

pub struct Saves(/* private fields */);

Saves an app makes outside its record, for the window’s save status.

The framework already presents the record’s own durability; this is for what it cannot see, such as a file the app writes. Report each save’s state as it changes (Self::saving, Self::saved, Self::failed); the window says nothing unless the save stalls or fails, and then offers “Try again”, which the app reads with Self::take_retry and answers by saving again. Clones share one report.

Implementations

impl Saves

pub fn saving(&self)

A save started and is not stored yet.

pub fn saved(&self)

The save landed.

pub fn failed(&self, reason: impl Into<String>)

The save failed; reason says why, in the person’s words.

pub fn report(&self, state: SaveState)

Report a save’s state.

pub fn take_retry(&self) -> bool

Whether the person asked to try the app’s stalled or failed save again, once. The app saves again and reports it.

pub fn state(&self) -> Option<SaveState>

The state last reported, None before any: for automation and tests, never for a “Saving…” or “Saved” of the app’s own.

Trait Implementations

impl Clone for Saves

fn clone(&self) -> Saves

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Saves

fn default() -> Saves

Returns the “default value” for a type.