Struct MessageBox 

pub struct MessageBox {
    pub style: Style,
    pub text_color: Color,
    pub button_text_color: Color,
    /* private fields */
}

LVGL-parity message-box dialog (LPAR-14 §5.H).

Combines a title header, a wrapped body message, and a button row into a single widget. The button row is implemented as an internal ButtonMatrix.

Button IDs

Buttons are assigned sequential ButtonId values in the order supplied to new. Use those IDs with active_button and [activate_button].

Fields

style: Style

Style for the outer container.

text_color: Color

Text colour for the title and body.

button_text_color: Color

Text colour for the button labels (forwarded to the inner matrix).

Implementations

impl MessageBox

pub fn new( bounds: Rect, title: &str, text: &str, buttons: &[&str], ) -> MessageBox

Create a MessageBox with the given bounds, title, body text, and button labels.

buttons is a slice of label strings. An empty slice creates a message-box with no footer buttons.

pub fn set_font(&mut self, font: &'static dyn FontMetrics)

Assign the font used to render this widget (FONT-00 §5); resolves to FONT_6X10 when unset.

pub fn title(&self) -> &str

Return the current title string.

pub fn set_title(&mut self, title: &str)

Replace the title string.

pub fn text(&self) -> &str

Return the current body text.

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

Replace the body text.

pub fn active_button(&self) -> ButtonId

Return the most-recently activated button, or BUTTON_NONE if no button has been activated yet.

pub fn activate_button(&mut self, id: ButtonId)

Programmatically activate button id, recording it as the active button. Equivalent to the user pressing a button.

pub fn button_text(&self, id: ButtonId) -> Option<&str>

Return the label of button id, or None if id is out of range.

pub fn button_count(&self) -> usize

Return the total number of buttons in the footer row.

pub fn close(&mut self) -> ButtonId

Signal that the dialog should be dismissed.

Records closed = true and returns the currently active_button. The caller must detach or hide the widget; no z-order or tree manipulation is performed.

pub fn is_closed(&self) -> bool

Return true after close has been called.

Trait Implementations

impl StyleProps for MessageBox

fn style_mut(&mut self) -> &mut Style

Return the mutable style used by this widget’s main visual part.

fn with_style(self, style: Style) -> Self

Replace the complete main style.

fn bg(self, color: Color) -> Self

Set the background color.

fn bg_color(self, color: Color) -> Self

Set the background color.

fn border_color(self, color: Color) -> Self

Set the border color.

fn border_width(self, width: u8) -> Self

Set the border width in pixels.

fn radius(self, radius: u8) -> Self

Set the corner radius in pixels.

fn rounded(self, radius: u8) -> Self

Set the corner radius in pixels.

fn opacity(self, alpha: u8) -> Self

Set widget opacity as 0..=255.

fn alpha(self, alpha: u8) -> Self

Set widget opacity as 0..=255.

impl ThemedPartsProps for MessageBox

fn themed_parts( self, theme: &Theme, scheme: ColorScheme, variant: Variant, size: ComponentSize, ) -> Self

Apply the theme to the main style and direct widget-specific part colors.

impl Widget for MessageBox

fn bounds(&self) -> Rect

Return the area this widget occupies relative to its parent.

fn widget_font_mut(&mut self) -> Option<&mut WidgetFont>

Expose this widget’s font slot for cascade-driven font resolution (FONT-05 §5.B).

fn set_bounds(&mut self, new_bounds: Rect)

Called by the LPAR-10 layout pass to notify this widget of its layout-computed bounds.

fn draw(&self, renderer: &mut dyn Renderer)

Render the widget using the provided Renderer.

fn handle_event(&mut self, event: &Event) -> bool

Handle an event and return true if it was consumed.

fn clear_region(&mut self) -> Option<Rect>

Return a region (in draw/landscape coordinates) that should be restored from the pristine background copy, or None.