Struct PlatformOutput

pub struct PlatformOutput {
    pub cursor_icon: CursorIcon,
    pub open_url: Option<OpenUrl>,
    pub copied_text: String,
    pub events: Vec<OutputEvent>,
    pub mutable_text_under_cursor: bool,
    pub text_cursor_pos: Option<Pos2>,
}

The non-rendering part of what egui emits each frame.

You can access (and modify) this with crate::Context::output.

The backend should use this.

Fields

cursor_icon: CursorIcon

Set the cursor to this icon.

open_url: Option<OpenUrl>

If set, open this url.

copied_text: String

If set, put this text in the system clipboard. Ignore if empty.

This is often a response to crate::Event::Copy or crate::Event::Cut.

if ui.button("📋").clicked() {
    ui.output_mut(|o| o.copied_text = "some_text".to_string());
}

events: Vec<OutputEvent>

Events that may be useful to e.g. a screen reader.

mutable_text_under_cursor: bool

Is there a mutable TextEdit under the cursor? Use by eframe web to show/hide mobile keyboard and IME agent.

text_cursor_pos: Option<Pos2>

Screen-space position of text edit cursor (used for IME).

Iff Some, the user is editing text.

Implementations

impl PlatformOutput

pub fn open_url(&mut self, url: impl ToString)

👎Deprecated: Use Context::open_url instead

Open the given url in a web browser.

If egui is running in a browser, the same tab will be reused.

pub fn events_description(&self) -> String

This can be used by a text-to-speech system to describe the events (if any).

pub fn append(&mut self, newer: PlatformOutput)

Add on new output.

pub fn take(&mut self) -> PlatformOutput

Take everything ephemeral (everything except cursor_icon currently)

Trait Implementations

impl Clone for PlatformOutput

fn clone(&self) -> PlatformOutput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for PlatformOutput

fn default() -> PlatformOutput

Returns the “default value” for a type.

impl PartialEq for PlatformOutput

fn eq(&self, other: &PlatformOutput) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for PlatformOutput