Struct SelectableText 

pub struct SelectableText<'a> { /* private fields */ }

A selectable text widget with right-click context menu support.

Wraps the plain Text widget to add text selection and a context menu (Copy / Select All), both on by default. Created with selectable_text; the plain text constructor and the typography presets return the unwrapped Text, so non-selectable text keeps iced’s looser trait bounds.

Use .selectable(false) for plain, non-interactive text, or .context_menu(false) to keep selection without the menu.

Implementations

impl<'a> SelectableText<'a>

pub fn new(content: impl IntoFragment<'a>) -> Self

Creates a new SelectableText widget with the given content.

Selection and the context menu are enabled by default.

pub fn selectable(self, enabled: bool) -> Self

Controls whether the text is selectable. On by default.

Pass false to render plain, non-interactive text (this also suppresses the context menu, which has nothing to act on).

pub fn context_menu(self, enabled: bool) -> Self

Controls whether the right-click context menu is shown. On by default.

Pass false to keep text selection but disable the context menu.

pub fn size(self, size: impl Into<Pixels>) -> Self

pub fn line_height(self, line_height: impl Into<LineHeight>) -> Self

pub fn font(self, font: impl Into<<Renderer as Renderer>::Font>) -> Self

pub fn font_maybe( self, font: Option<impl Into<<Renderer as Renderer>::Font>>, ) -> Self

pub fn width(self, width: impl Into<Length>) -> Self

pub fn height(self, height: impl Into<Length>) -> Self

pub fn center(self) -> Self

pub fn align_x(self, alignment: impl Into<Alignment>) -> Self

pub fn align_y(self, alignment: impl Into<Vertical>) -> Self

pub fn shaping(self, shaping: Shaping) -> Self

pub fn wrapping(self, wrapping: Wrapping) -> Self

pub fn ellipsize(self, ellipsize: Ellipsize) -> Self

pub fn style(self, style: impl Fn(&Theme) -> Style + 'a) -> Self

where <Theme as Catalog>::Class<'a>: From<StyleFn<'a, Theme>>,

pub fn color(self, color: impl Into<Color>) -> Self

where <Theme as Catalog>::Class<'a>: From<StyleFn<'a, Theme>>,

pub fn color_maybe(self, color: Option<impl Into<Color>>) -> Self

where <Theme as Catalog>::Class<'a>: From<StyleFn<'a, Theme>>,

pub fn class(self, class: impl Into<<Theme as Catalog>::Class<'a>>) -> Self

Trait Implementations

impl<'a> From<&'a str> for SelectableText<'a>

fn from(content: &'a str) -> Self

Converts to this type from the input type.

impl<'a, Message: Clone + 'static> From<SelectableText<'a>> for Element<'a, Message>

fn from(text: SelectableText<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<Text<'a, Theme, Renderer>> for SelectableText<'a>

fn from(inner: Text<'a, Theme, Renderer>) -> Self

Converts to this type from the input type.

impl<'a, Message: Clone + 'static> Widget<Message, Theme, Renderer> for SelectableText<'a>

fn tag(&self) -> Tag

Returns the Tag of the Widget.

fn state(&self) -> State

Returns the State of the Widget.

fn children(&self) -> Vec<Tree>

Returns the state Tree of the children of the Widget.

fn diff(&mut self, tree: &mut Tree)

Reconciles the Widget with the provided Tree.

fn size(&self) -> Size<Length>

Returns the Size of the Widget in lengths.

fn layout( &mut self, tree: &mut Tree, renderer: &Renderer, limits: &Limits, ) -> Node

Returns the layout::Node of the Widget.

fn draw( &self, tree: &Tree, renderer: &mut Renderer, theme: &Theme, defaults: &Style, layout: Layout<'_>, cursor: Cursor, viewport: &Rectangle, )

Draws the Widget using the associated Renderer.

fn update( &mut self, tree: &mut Tree, event: &Event, layout: Layout<'_>, cursor: Cursor, renderer: &Renderer, clipboard: &mut dyn Clipboard, shell: &mut Shell<'_, Message>, viewport: &Rectangle, )

Processes a runtime Event.

fn mouse_interaction( &self, tree: &Tree, layout: Layout<'_>, cursor: Cursor, viewport: &Rectangle, renderer: &Renderer, ) -> Interaction

Returns the current mouse::Interaction of the Widget.

fn overlay<'b>( &'b mut self, tree: &'b mut Tree, _layout: Layout<'b>, _renderer: &Renderer, _viewport: &Rectangle, translation: Vector, ) -> Option<Element<'b, Message, Theme, Renderer>>

Returns the overlay of the Widget, if there is any.

fn operate( &mut self, tree: &mut Tree, layout: Layout<'_>, renderer: &Renderer, operation: &mut dyn Operation, )

Applies an Operation to the Widget.

fn a11y_nodes( &self, layout: Layout<'_>, state: &Tree, cursor: Cursor, ) -> A11yTree

Available on crate feature a11y only.

get the a11y nodes for the widget and its children

fn id(&self) -> Option<Id>

Returns the id of the widget

fn set_id(&mut self, id: Id)

Sets the id of the widget This may be called while diffing the widget tree

fn size_hint(&self) -> Size<Length>

Returns a Size hint for laying out the Widget.

fn drag_destinations( &self, _state: &Tree, _layout: Layout<'_>, _renderer: &Renderer, _dnd_rectangles: &mut DndDestinationRectangles, )

Adds the drag destination rectangles of the widget. Runs after the layout phase for each widget in the tree.