Struct Clipboard

pub struct Clipboard { /* private fields */ }

Manages access to the system clipboard for text-based copy and paste operations.

This struct acts as a handle to the platform’s native clipboard, abstracting away the underlying implementation details. It is created using Clipboard::new().

All interactions are synchronous. For unsupported platforms (e.g., Android), operations are gracefully handled to prevent runtime errors.

Implementations

impl Clipboard

pub fn new() -> Self

Creates a new clipboard instance, initializing the connection to the system clipboard.

This method may fail if the system clipboard is unavailable, in which case it will panic.

Panics

Panics if the clipboard provider cannot be initialized. This can happen in environments without a graphical user interface or due to system-level permission issues.

Example

use tessera_ui::clipboard::Clipboard;

let clipboard = Clipboard::new();

pub fn set_text(&mut self, text: &str)

Sets the clipboard text, overwriting any previous content.

Arguments

• text - The string slice to be copied to the clipboard.

Example

use tessera_ui::clipboard::Clipboard;

let mut clipboard = Clipboard::new();
clipboard.set_text("Hello, world!");

pub fn get_text(&mut self) -> Option<String>

Gets the current text content from the clipboard.

This method retrieves text from the clipboard. If the clipboard is empty, contains non-text content, or an error occurs, it returns None.

Returns

• Some(String) if text is successfully retrieved from the clipboard.
• None if the clipboard is empty, contains non-text data, or an error occurs.

Example

use tessera_ui::clipboard::Clipboard;

let mut clipboard = Clipboard::new();
clipboard.set_text("Hello, Tessera!");

if let Some(text) = clipboard.get_text() {
    println!("Retrieved from clipboard: {}", text);
} else {
    println!("Clipboard was empty or contained non-text content.");
}

pub fn clear(&mut self)

Clears the clipboard content.

Example

use tessera_ui::clipboard::Clipboard;

let mut clipboard = Clipboard::new();
clipboard.set_text("Temporary text"); // "Temporary text" is now in the clipboard
clipboard.clear(); // The clipboard is now cleared

Trait Implementations

impl Default for Clipboard

fn default() -> Self

Creates a new Clipboard instance using default settings.

This is equivalent to calling Clipboard::new().

Example

use tessera_ui::clipboard::Clipboard;

let clipboard = Clipboard::default();