Struct TreeTableViewHandle 

pub struct TreeTableViewHandle { /* private fields */ }

A handle on a mounted TreeTableView, to scroll it to a row from outside the widget — a view-model revealing the node a search found, say.

Rows are addressed by their flat visible index, as by TreeTableView::scroll_to_row: the position of the row among the rows currently shown, counting the children of expanded nodes and skipping those of collapsed ones. With pinned_ancestors the row is revealed below the ancestors pinned over it.

Cheap to clone, valid before the view is mounted, and it survives the view’s rebuilds. Its methods never compute an offset when they are called: they record the request and ask for a layout pass, and the view applies it there, after row measurement and scroll anchoring have settled. So a structural change made in the same turn (a node expanded above the target, say) is accounted for, a request made before mount is applied at the first layout, and a later request replaces an earlier pending one. A request on a view with no rows is dropped; a row past the end reveals the last row.

let view = TreeTableView::new(model);
let handle = view.handle();
// … add the columns, `ctx.add(view)`; later, after expanding the row's
// ancestors:
handle.ensure_row_visible(42);

Implementations

impl TreeTableViewHandle

pub fn scroll_to_row(&self, row: usize)

Scroll so that row (a flat visible index) is aligned to the top of the viewport, as far as the scroll range allows, at the next layout pass.

pub fn ensure_row_visible(&self, row: usize)

Scroll the minimum distance that makes row (a flat visible index) fully visible, at the next layout pass; no scroll when it already is.

Trait Implementations

impl Clone for TreeTableViewHandle

fn clone(&self) -> TreeTableViewHandle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TreeTableViewHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.