Struct Tabview 

pub struct Tabview {
    pub style: Style,
    pub tab_color: Color,
    pub active_tab_color: Color,
    pub tab_text_color: Color,
    pub active_tab_text_color: Color,
    /* private fields */
}

Tab bar + content-pane navigation widget.

Create with Tabview::new, add tabs with Tabview::add_tab, and switch the active tab with Tabview::set_active or the navigation helpers.

Fields

style: Style

Overall widget background style (Part::MAIN).

tab_color: Color

Background color for inactive tab buttons (Part::ITEMS).

active_tab_color: Color

Background color for the active tab button (Part::SELECTED).

tab_text_color: Color

Text color for inactive tabs.

active_tab_text_color: Color

Text color for the active tab.

Implementations

impl Tabview

pub const TAB_NONE: TabId

Sentinel TabId meaning “no tab selected / invalid”.

pub fn new(bounds: Rect, bar_pos: TabBarPos) -> Self

Create a new tabview with the given bounds and tab bar position.

The tab bar uses the default thickness of 24 pixels. Adjust with set_bar_pos and set_bounds.

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 add_tab(&mut self, name: &str) -> TabId

Append a tab with the given name and return its TabId.

If this is the first tab, it becomes the active tab automatically.

pub fn rename_tab(&mut self, id: TabId, name: &str)

Rename the tab with the given id.

No-op if the id is out of range or TAB_NONE.

pub fn set_active(&mut self, id: TabId)

Make the tab with the given id the active one.

No-op if the id is out of range or TAB_NONE.

pub fn active_tab(&self) -> TabId

Return the TabId of the currently active tab, or TAB_NONE.

pub fn tab_count(&self) -> usize

Return the number of registered tabs.

pub fn tab_content_bounds(&self, id: TabId) -> Rect

Return the content-area rect for the given tab id.

All tabs share the same content-area geometry (the bounding rect minus the tab bar). Returns a zero-area rect if id is out of range.

pub fn bar_pos(&self) -> TabBarPos

Return the tab bar position.

pub fn set_bar_pos(&mut self, pos: TabBarPos)

Set the tab bar position and recompute internal geometry.

pub fn navigate_next_tab(&mut self)

Advance to the next tab, wrapping from the last back to the first.

No-op when there are fewer than two tabs.

Wire to ObjectEvent::Key(Key::ArrowRight) or Key::Tab from the application handler.

pub fn navigate_prev_tab(&mut self)

Move to the previous tab, wrapping from the first back to the last.

No-op when there are fewer than two tabs.

Wire to ObjectEvent::Key(Key::ArrowLeft) from the application handler.

Trait Implementations

impl Widget for Tabview

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, 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.