Struct clipboard_win::Clipboard

pub struct Clipboard { /* fields omitted */ }

Clipboard accessor.

Note:

You can have only one such accessor across your program.

Warning:

In Windows Clipboard opens globally and only one application can set data onto format at the time.

Therefore as soon as operations are finished, user is advised to close Clipboard.

Methods

impl Clipboard

pub fn new() -> Result<Clipboard>

Initializes new clipboard accessor.

Attempts to open clipboard.

pub fn empty(&self) -> Result<&Clipboard>

Empties clipboard.

pub fn size(&self, format: u32) -> Option<usize>

Retrieves size of clipboard content.

pub fn set(&self, format: u32, data: &[u8]) -> Result<()>

Sets data onto clipboard with specified format.

Wraps raw::set()

pub fn set_string<T: ?Sized + AsRef<OsStr>>(&self, data: &T) -> Result<()>

Sets str or String onto clipboard as Unicode format.

Under hood it transforms Rust UTF-8 String into UTF-16

pub fn get(&self, format: u32, data: &mut [u8]) -> Result<usize>

Retrieves data of specified format from clipboard.

Wraps raw::get()

pub fn get_string(&self) -> Result<String>

Retrieves String of CF_UNICODETEXT format from clipboard.

Wraps raw::get_string()

pub fn get_file_list(&self) -> Result<Vec<PathBuf>>

Retrieves a list of file paths from the CF_HDROP format from the clipboard.

Wraps raw::get_file_list()

pub fn get_bit_map(&self) -> Result<Bitmap>

Retrieves Bitmap of CF_BITMAP format from clipboard.

Important traits for EnumFormats

impl Iterator for EnumFormats type Item = u32;

pub fn enum_formats(&self) -> EnumFormats

Enumerator over all formats on clipboard..

pub fn seq_num() -> Option<u32>

Returns Clipboard sequence number.

pub fn is_format_avail(format: u32) -> bool

Determines whenever provided clipboard format is available on clipboard or not.

pub fn count_formats() -> Result<i32>

Retrieves number of currently available formats on clipboard.

Trait Implementations

impl Drop for Clipboard

fn drop(&mut self)

Executes the destructor for this type.