Struct CLIPBOARD 

pub struct CLIPBOARD;

Clipboard service.

This service synchronizes with the UI update cycle, the getter methods provide the same data for all requests in the same update pass, even if the system clipboard happens to change mid update, the setter methods only set the system clipboard at the end of the update pass.

This service needs a running view-process to actually interact with the system clipboard, in a headless app without renderer (no view-process) the service will always return ClipboardError::Disconnected.

Implementations

impl CLIPBOARD

pub fn text(&self) -> Result<Option<Txt>, ClipboardError>

Gets a text string from the clipboard.

pub fn set_text( &self, txt: impl Into<Txt>, ) -> ResponseVar<Result<(), ClipboardError>>

Sets the text string on the clipboard after the current update.

Returns a response var that updates once the text is set.

pub fn image(&self) -> Result<Option<ImageVar>, ClipboardError>

Gets an image from the clipboard.

The image is loaded in parallel by the IMAGES service, it is not cached.

pub fn set_image( &self, img: ImageEntry, ) -> ResponseVar<Result<(), ClipboardError>>

Set the image on the clipboard after the current update, if it is loaded.

Returns a response var that updates once the image is set.

pub fn paths(&self) -> Result<Option<Vec<PathBuf>>, ClipboardError>

Gets a path list from the clipboard.

pub fn set_paths( &self, list: impl Into<Vec<PathBuf>>, ) -> ResponseVar<Result<(), ClipboardError>>

Sets the file list on the clipboard after the current update.

Returns a response var that updates once the paths are set.

pub fn extension( &self, data_type: impl Into<Txt>, ) -> Result<Option<IpcBytes>, ClipboardError>

Gets custom data from the clipboard.

The current view-process must support data_type.

pub fn set_extension( &self, data_type: impl Into<Txt>, data: IpcBytes, ) -> ResponseVar<Result<(), ClipboardError>>

Set a custom data on the clipboard.

The current view-process must support data_type after the current update.

pub fn available_types(&self) -> ClipboardTypes

Get what clipboard types and operations the current view-process implements.