Struct rerun::external::eframe::egui::widgets::Button

pub struct Button<'a> {

    image: Option<Image<'a>>,
    text: Option<WidgetText>,
    shortcut_text: WidgetText,
    wrap_mode: Option<TextWrapMode>,
    fill: Option<Color32>,
    stroke: Option<Stroke>,
    sense: Sense,
    small: bool,
    frame: Option<bool>,
    min_size: Vec2,
    rounding: Option<Rounding>,
    selected: bool,
    image_tint_follows_text_color: bool,
}

Clickable button with text.

See also Ui::button.

if ui.add(egui::Button::new("Click me")).clicked() {
    do_stuff();
}

// A greyed-out and non-interactive button:
if ui.add_enabled(false, egui::Button::new("Can't click this")).clicked() {
    unreachable!();
}

Fields

image: Option<Image<'a>>

text: Option<WidgetText>

shortcut_text: WidgetText

wrap_mode: Option<TextWrapMode>

fill: Option<Color32>

stroke: Option<Stroke>

sense: Sense

small: bool

frame: Option<bool>

min_size: Vec2

rounding: Option<Rounding>

selected: bool

image_tint_follows_text_color: bool

Implementations

impl<'a> Button<'a>

pub fn new(text: impl Into<WidgetText>) -> Button<'a>

pub fn image(image: impl Into<Image<'a>>) -> Button<'a>

Creates a button with an image. The size of the image as displayed is defined by the provided size.

pub fn image_and_text( image: impl Into<Image<'a>>, text: impl Into<WidgetText>, ) -> Button<'a>

Creates a button with an image to the left of the text. The size of the image as displayed is defined by the provided size.

pub fn opt_image_and_text( image: Option<Image<'a>>, text: Option<WidgetText>, ) -> Button<'a>

pub fn wrap_mode(self, wrap_mode: TextWrapMode) -> Button<'a>

Set the wrap mode for the text.

By default, crate::Ui::wrap_mode will be used, which can be overridden with crate::Style::wrap_mode.

Note that any \n in the text will always produce a new line.

pub fn wrap(self) -> Button<'a>

Set Self::wrap_mode to TextWrapMode::Wrap.

pub fn truncate(self) -> Button<'a>

Set Self::wrap_mode to TextWrapMode::Truncate.

pub fn fill(self, fill: impl Into<Color32>) -> Button<'a>

Override background fill color. Note that this will override any on-hover effects. Calling this will also turn on the frame.

pub fn stroke(self, stroke: impl Into<Stroke>) -> Button<'a>

Override button stroke. Note that this will override any on-hover effects. Calling this will also turn on the frame.

pub fn small(self) -> Button<'a>

Make this a small button, suitable for embedding into text.

pub fn frame(self, frame: bool) -> Button<'a>

Turn off the frame

pub fn sense(self, sense: Sense) -> Button<'a>

By default, buttons senses clicks. Change this to a drag-button with Sense::drag().

pub fn min_size(self, min_size: Vec2) -> Button<'a>

Set the minimum size of the button.

pub fn rounding(self, rounding: impl Into<Rounding>) -> Button<'a>

Set the rounding of the button.

pub fn image_tint_follows_text_color( self, image_tint_follows_text_color: bool, ) -> Button<'a>

If true, the tint of the image is multiplied by the widget text color.

This makes sense for images that are white, that should have the same color as the text color. This will also make the icon color depend on hover state.

Default: false.

pub fn shortcut_text(self, shortcut_text: impl Into<WidgetText>) -> Button<'a>

Show some text on the right side of the button, in weak color.

Designed for menu buttons, for setting a keyboard shortcut text (e.g. Ctrl+S).

The text can be created with crate::Context::format_shortcut.

pub fn selected(self, selected: bool) -> Button<'a>

If true, mark this button as “selected”.

Trait Implementations

impl Widget for Button<'_>

fn ui(self, ui: &mut Ui) -> Response

Allocate space, interact, paint, and return a Response.