Struct HostRecorder 

pub struct HostRecorder { /* private fields */ }

What a HostServices::recording host was asked to do, and the answers it will give.

Copies round-trip through an in-process clipboard; pickers and launches answer queued outcomes, then Cancelled (launches: Opened); location requests answer queued fixes, then Unavailable; screen-capture requests answer queued outcomes, then Cancelled; URIs, utterances and notifications are recorded; media sessions start and record what the player publishes.

Implementations

impl HostRecorder

pub fn copies(&self) -> Vec<(ClipboardTarget, String)>

Every text copy, in order.

pub fn copy_image_elsewhere(&self, image: ClipboardImage)

Another app copies image, as a screenshot tool does: the next paste reads it, until something copies text.

pub fn opened_uris(&self) -> Vec<String>

Every URI handed to the opener, in order.

pub fn pick_requests(&self) -> Vec<PickRequest>

Every chooser request, in order.

pub fn launch_requests(&self) -> Vec<LaunchRequest>

Every desktop-open request, in order.

pub fn respond_to_pick(&self, outcome: PortalOutcome)

Answer the next single-file chooser with outcome.

pub fn respond_to_pick_multiple(&self, outcome: MultiOutcome)

Answer the next multi-select chooser with outcome.

pub fn respond_to_open_file(&self, outcome: OpenFileOutcome)

Answer the next descriptor-retaining chooser with outcome.

pub fn respond_to_launch(&self, outcome: LaunchOutcome)

Answer the next desktop-open request with outcome.

pub fn respond_to_location(&self, outcome: LocationOutcome)

Answer the next location request with outcome.

pub fn location_requests(&self) -> usize

How many location fixes were requested.

pub fn screen_capture_requests(&self) -> Vec<ScreenCaptureRequest>

Every screen-capture request, in order.

pub fn utterances(&self) -> Vec<Utterance>

Everything the screen reader was asked to say, in order.

pub fn notifications(&self) -> Vec<Notification>

Every notification shown, in order.

pub fn media_sessions(&self) -> Vec<MprisConfig>

The configuration of every media session started, in order.

pub fn published_media_state(&self) -> Vec<PlayerSnapshot>

Every player state published to a media session, in order.

Trait Implementations

impl Clone for HostRecorder

fn clone(&self) -> HostRecorder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for HostRecorder

fn default() -> HostRecorder

Returns the “default value” for a type.

impl FilePicker for HostRecorder

fn pick(&self, request: PickRequest) -> Receiver<PortalOutcome>

A single-file Open, Save or folder chooser.

fn pick_multiple(&self, request: PickRequest) -> Receiver<MultiOutcome>

A multi-select Open chooser.

fn open_file(&self, request: PickRequest) -> Receiver<OpenFileOutcome>

A single-file Open chooser that delivers the already-open descriptor.

fn launch(&self, request: LaunchRequest) -> Receiver<LaunchOutcome>

Open a local path with its default handler, or reveal its folder.

fn save_file(&self, request: PickRequest) -> Receiver<OpenFileOutcome>

A Save chooser that delivers the chosen destination already open for writing, for hosts whose documents have no path the app can write to. Hosts that answer Save with a path keep this default refusal.

fn pick_contents(&self, request: PickRequest) -> Receiver<ContentsOutcome>

An Open chooser that delivers the chosen files’ contents. The default reads what pick or pick_multiple answers; a host without local paths (a browser page) implements it directly. Implementations must enforce the aggregate PickRequest::contents_byte_limit before reading unbounded contents.

fn save_contents( &self, request: PickRequest, bytes: Vec<u8>, ) -> Receiver<SaveOutcome>

A Save chooser that stores bytes. The default writes to the path pick answers.

impl LocationProvider for HostRecorder

fn locate(&self) -> Receiver<LocationOutcome>

Request one fix. Answers over the channel, never blocking the caller.

impl MediaSessionFactory for HostRecorder

fn start( &self, config: MprisConfig, _initial: PlayerSnapshot, ) -> Option<MediaSession>

Register a player described by config, starting from initial. None when the host has no media controls; the player then stays inert.

impl MediaSessionPublisher for HostRecorder

fn publish(&mut self, snapshot: PlayerSnapshot)

Publish the latest player state. Must not block.

impl Notifier for HostRecorder

fn show(&self, notification: &Notification) -> Result<(), NotifyError>

Show notification, replacing any earlier one with the same tag.

fn withdraw(&self, tag: &str) -> Result<(), NotifyError>

Withdraw the notification shown under tag, if any.

fn schedule( &self, notification: &Notification, at: SystemTime, ) -> Result<(), NotifyError>

Have the platform show notification at at, even if this app is no longer running. Scheduling a tag again replaces the earlier one.

fn schedule_alarm( &self, notification: &Notification, at: SystemTime, schedule: AlarmSchedule, ) -> Result<(), NotifyError>

Schedule a local-time alarm. Hosts that understand calendar alarms retain recurrence and timezone semantics after the app closes; other hosts retain the supplied next occurrence through schedule.

fn alarm_states(&self) -> Result<Vec<AlarmState>, NotifyError>

Calendar handoffs and delivered occurrences owned by this app. Hosts that retain only an absolute deadline return no calendar state.

fn scheduled(&self) -> Result<Vec<Scheduled>, NotifyError>

The notifications this app has scheduled that are not yet delivered.

fn cancel_scheduled(&self, tag: &str) -> Result<(), NotifyError>

Cancel the scheduled notification under tag, if any.

impl ScreenCaptureProvider for HostRecorder

fn request( &self, request: ScreenCaptureRequest, ) -> Receiver<ScreenCaptureOutcome>

Ask the user for a screen or window to capture. Answers over the channel, never blocking the caller while the host shows its picker.

impl SpeechFactory for HostRecorder

fn make(&self) -> Box<dyn Speaker>

A fresh speaker. Must not fail: a host without speech returns a [tts::NullSpeaker].

impl UriOpener for HostRecorder

fn open(&self, uri: &str) -> Result<(), Error>

Open uri without waiting for the handler to finish. May block until the handler is launched or the request is refused, so the toolkit calls it off the UI thread.