Struct Tileview 

pub struct Tileview {
    pub style: Style,
    pub tile_color: Color,
    /* private fields */
}

Two-dimensional snap-to-tile navigation grid.

Create with Tileview::new, register tiles with Tileview::add_tile, and navigate with the direction helpers.

Fields

style: Style

Overall background style (Part::MAIN).

tile_color: Color

Background color drawn for the active tile area.

Implementations

impl Tileview

pub const TILE_NONE: TileId

Sentinel TileId meaning “no tile selected / invalid”.

pub fn new(bounds: Rect) -> Self

Create a tileview with no tiles.

pub fn add_tile(&mut self, col: u8, row: u8, dir: TileDir) -> TileId

Register a tile at (col, row) with the given allowed navigation directions.

Returns the tile’s TileId. If this is the first tile, it becomes the active tile automatically.

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

Make the tile with the given id active.

Snaps the view directly to the tile’s grid position. No-op if the id is out of range or TILE_NONE.

pub fn active_tile(&self) -> TileId

Return the TileId of the currently active tile, or TILE_NONE.

pub fn set_active_by_index(&mut self, col: u8, row: u8)

Activate the tile at grid position (col, row).

If no tile is registered at that position, this is a no-op.

pub fn tile_bounds(&self, id: TileId) -> Rect

Return the content-space bounds of the tile with the given id.

Bounds are always (col * w, row * h, w, h) where w and h are the widget viewport dimensions. Returns a zero-area rect for invalid ids.

pub fn navigate_up(&mut self)

Navigate to the tile above the current one, if allowed.

Requires TileDir::UP to be set on the active tile and a tile registered at (col, row - 1). Wire to ObjectEvent::Key(Key::ArrowUp).

pub fn navigate_down(&mut self)

Navigate to the tile below the current one, if allowed.

Requires TileDir::DOWN on the active tile and a tile at (col, row + 1). Wire to ObjectEvent::Key(Key::ArrowDown).

pub fn navigate_left(&mut self)

Navigate to the tile to the left of the current one, if allowed.

Requires TileDir::LEFT on the active tile and a tile at (col - 1, row). Wire to ObjectEvent::Key(Key::ArrowLeft).

pub fn navigate_right(&mut self)

Navigate to the tile to the right of the current one, if allowed.

Requires TileDir::RIGHT on the active tile and a tile at (col + 1, row). Wire to ObjectEvent::Key(Key::ArrowRight).

Trait Implementations

impl Widget for Tileview

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