2023-03-04 05:37:11 +01:00
|
|
|
//! Access the clipboard.
|
|
|
|
|
|
|
|
|
|
/// A buffer for short-term storage and transfer within and between
|
|
|
|
|
/// applications.
|
|
|
|
|
pub trait Clipboard {
|
|
|
|
|
/// Reads the current content of the [`Clipboard`] as text.
|
2024-02-13 03:14:08 +01:00
|
|
|
fn read(&self, kind: Kind) -> Option<String>;
|
2023-03-04 05:37:11 +01:00
|
|
|
|
|
|
|
|
/// Writes the given text contents to the [`Clipboard`].
|
2024-02-13 03:14:08 +01:00
|
|
|
fn write(&mut self, kind: Kind, contents: String);
|
|
|
|
|
}
|
2024-02-07 17:25:40 +01:00
|
|
|
|
2024-02-13 03:14:08 +01:00
|
|
|
/// The kind of [`Clipboard`].
|
|
|
|
|
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
|
|
|
|
pub enum Kind {
|
|
|
|
|
/// The standard clipboard.
|
|
|
|
|
Standard,
|
|
|
|
|
/// The primary clipboard.
|
|
|
|
|
///
|
|
|
|
|
/// Normally only present in X11 and Wayland.
|
|
|
|
|
Primary,
|
2023-03-04 05:37:11 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/// A null implementation of the [`Clipboard`] trait.
|
|
|
|
|
#[derive(Debug, Clone, Copy)]
|
|
|
|
|
pub struct Null;
|
|
|
|
|
|
|
|
|
|
impl Clipboard for Null {
|
2024-02-13 03:14:08 +01:00
|
|
|
fn read(&self, _kind: Kind) -> Option<String> {
|
2024-02-07 17:25:40 +01:00
|
|
|
None
|
|
|
|
|
}
|
|
|
|
|
|
2024-02-13 03:14:08 +01:00
|
|
|
fn write(&mut self, _kind: Kind, _contents: String) {}
|
2023-03-04 05:37:11 +01:00
|
|
|
}
|