Struct ListViewWidget 

pub struct ListViewWidget { /* private fields */ }

The retained widget for a ListView: the materialized window of children (children[j] renders item keys[j]), the scroll offset + cached viewport, and the same fling bookkeeping as crate::ScrollWidget.

Implementations

impl ListViewWidget

pub fn offset(&self) -> f64

The current scroll offset.

pub fn window(&self) -> &[usize]

The item indices currently materialized (the visible window ± buffer).

pub fn max_offset(&self) -> f64

The maximum scroll offset (extent − viewport, never negative).

pub fn is_flinging(&self) -> bool

Whether post-release motion is in flight — the legacy fling, or a physics-supplied Simulation the generic driver is running (never both, and never either one under RubberBand’s legacy-only path).

pub fn settle_tick(&mut self, dt_ms: f64) -> bool

Advance a release-settle by dt_ms, easing ListViewWidget::overscroll back to 0.0 and returning whether it is still animating. Pure and deterministic (mirrors crate::ScrollWidget::settle_tick); the paint pump and the tests both drive it. Only ever eases overscroll — the windowing ListViewWidget::offset already sits at the exact edge (0.0 or max_offset) the moment a drag overscrolls, so it needs no motion of its own here.

pub fn tick(&mut self, dt_ms: f64) -> bool

Advance an in-flight fling by dt_ms, returning whether it is still animating. Pure and deterministic — the paint-time pump and the tests both drive it (mirrors crate::ScrollWidget::tick).

Trait Implementations

impl Widget for ListViewWidget

fn layout(&mut self, ctx: &mut LayoutCtx<'_>, bc: &BoxConstraints) -> Size

Choose a size within bc and return it. Under a render root the call may be skipped (see ChildPod::layout_child), so the result must depend only on bc, the context’s globals and state changed through a pod-dirtying channel: a LAYOUT rebuild, request_layout, an unpaced frame request, or a handled / redraw-requesting event.

fn paint(&mut self, ctx: &mut PaintCtx<'_>, scene: &mut dyn PaintScene)

Emit draw commands into scene. Paint may advance animation state; it must then call PaintCtx::request_frame until the animation rests.

fn event(&mut self, ctx: &mut EventCtx<'_>, event: &InputEvent) -> EventResult

Handle an input event and report whether it was consumed; defaults to EventResult::Ignored. Containers forward via ChildPod::event_child.

fn semantics(&self, ctx: &mut SemanticsCtx)

Contribute accessibility node(s) after layout; defaults to none. A container forwards via ChildPod::semantics_child.

fn visit_children(&self, visitor: &mut dyn FnMut(&ChildPod))

Visit this widget’s owned ChildPods in paint order, for read-only tooling; defaults to none and must not mutate pass state.

fn type_name(&self) -> &'static str

This widget’s concrete type name, for diagnostics only (docs/LIMITATIONS.md focus-wrapper-erasure-swap-blind); override only in a transparent wrapper.

fn is_focusable(&self) -> bool

Whether keyboard traversal (Tab / Shift+Tab at the root) may stop on this widget’s pod.

fn visit_focus_children(&self, visitor: &mut dyn FnMut(&ChildPod))

Visit the children traversal may enter, in focus order; defaults to Widget::visit_children. A container showing only some children narrows it.

fn as_sliver(&mut self) -> Option<&mut (dyn SliverWidget + 'static)>

This widget as a sliver (crate::sliver), if it speaks that protocol. Defaults to None; transparent wrappers forward it.