Struct ImageButton 

pub struct ImageButton { /* private fields */ }

State-specific segmented image button.

State fallback (§5.D)

When a state’s middle source is absent, the widget walks a fallback chain until a middle source is found:

• Pressed → Released
• CheckedReleased → Released
• CheckedPressed → CheckedReleased → Pressed → Released
• Disabled → Released
• CheckedDisabled → CheckedReleased → Released

Event handling

Pointer PressDown inside bounds sets the visual pressed state. PressRelease inside bounds activates the button (returns true). Disabled buttons consume no activation.

Implementations

impl ImageButton

pub fn new(bounds: Rect) -> Self

Create a new image button occupying bounds in the released state.

pub fn set_src( &mut self, state: ImageButtonState, left: Option<ImageDescriptor<'static>>, middle: Option<ImageDescriptor<'static>>, right: Option<ImageDescriptor<'static>>, )

Set the left, middle, and right sources for state.

Pass None for any segment that should be absent. The middle segment must be set for the button to draw content; a missing middle is allowed but produces no visible image.

pub fn src_left( &self, state: ImageButtonState, ) -> Option<&ImageDescriptor<'static>>

Return the left source configured for state (no fallback applied).

pub fn src_middle( &self, state: ImageButtonState, ) -> Option<&ImageDescriptor<'static>>

Return the middle source configured for state (no fallback applied).

pub fn src_right( &self, state: ImageButtonState, ) -> Option<&ImageDescriptor<'static>>

Return the right source configured for state (no fallback applied).

pub fn set_state(&mut self, state: ImageButtonState)

Set the app-controlled base state.

Use ImageButtonState::Disabled or ImageButtonState::CheckedDisabled to prevent pointer activation.

pub fn state(&self) -> ImageButtonState

Return the app-controlled base state.

pub fn set_checked(&mut self, checked: bool)

Set the checked (toggled on) state.

pub fn checked(&self) -> bool

Return true when the button is in the checked state.

pub fn draw_state(&self) -> ImageButtonState

Compute the effective draw state from the base state, checked flag, and whether a pointer is currently held.

Trait Implementations

impl Widget for ImageButton

fn bounds(&self) -> Rect

Return the area this widget occupies relative to its parent.

fn set_bounds(&mut self, 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.

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

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