Struct AttachmentSummary 

pub struct AttachmentSummary<'a> {
    pub kind: AttachmentKind,
    pub name: &'a str,
    pub size: Option<u64>,
    pub availability: Availability,
    pub saved: Option<SavedCopy>,
}

Everything the ladder needs to know about one attachment.

Fields

kind: AttachmentKind

name: &'a str

The name it was shared under: the identity of the file, used for the save dialog’s suggestion.

size: Option<u64>

Its size in bytes, when known.

availability: Availability

saved: Option<SavedCopy>

Where a copy was saved, if the person saved one in this session.

Implementations

impl<'a> AttachmentSummary<'a>

pub fn ready( kind: AttachmentKind, name: &'a str, size: Option<u64>, ) -> AttachmentSummary<'a>

An attachment whose bytes are here.

pub fn in_state(self, availability: Availability) -> AttachmentSummary<'a>

The same attachment, in another state.

pub fn saved_as(self, saved: SavedCopy) -> AttachmentSummary<'a>

The same attachment, with the copy the person saved.

pub fn actions(&self) -> Vec<AttachmentAction>

The rungs on offer, in order: open, save, open the saved copy — or cancel, while the transport is still working.

A picture that cannot be read offers nothing: the ladder starts below a preview that is not there, and Self::unavailable_reason says why in the place the rungs would have been.

pub fn unavailable_reason(&self) -> Option<String>

Why there is nothing to do, when there is nothing to do.

pub fn suggested_name(&self) -> String

The name the save dialog suggests: the name it was shared under.

pub fn describe(&self) -> String

What a screen reader hears for this attachment: what it is, what it is called, how big it is, and what state it is in. A copy on this device is stated as a state rather than announced as an event: saving says nothing unless it stalls or fails, and a person reading a list with a screen reader still needs to know where the file is.

Trait Implementations

impl<'a> Clone for AttachmentSummary<'a>

fn clone(&self) -> AttachmentSummary<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for AttachmentSummary<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.