Struct TreeView 

pub struct TreeView<BackendT, ContextT, ErrorT, IdT, DataT> {
    pub model: TreeModel<BackendT, ContextT, ErrorT, IdT, DataT>,
    pub selected_row: Option<usize>,
    pub page: usize,
    pub debug: bool,
}

Tree view.

Nodes can be leaves (no children) or branches (potentially have children) and can have custom data (DataT) attached to them. Their representation can be stylized with multiple colors and effects.

Supported events:

• Up/Down keys: move selection
• PgUp/PgDown keys: move selection by 10 (configurable)
• Left/Right keys: collapse/expand branch node
• Enter key: toggle branch collapse/expand
• Mouse click on node: select
• Mouse click to the left of the node: toggle branch collapse/expand

The view’s data and behavior are backed by a TreeBackend. The nodes are stored and managed by a TreeModel. The model can be populated in advance and can also fetch data from the backend on demand, e.g. when a branch node is expanded.

Fields

model: TreeModel<BackendT, ContextT, ErrorT, IdT, DataT>

Tree model.

selected_row: Option<usize>

Selected row.

page: usize

Page size for PgUp/PgDown.

debug: bool

Whether we want to display debug information.

Implementations

impl<BackendT, ContextT, ErrorT, IdT, DataT> TreeView<BackendT, ContextT, ErrorT, IdT, DataT>

where BackendT: 'static + TreeBackend<ContextT, ErrorT, IdT, DataT> + Send + Sync, DataT: 'static + Send + Sync,

pub fn selected_node( &self, ) -> Option<&Node<BackendT, ContextT, ErrorT, IdT, DataT>>

The selected node.

pub fn selected_path(&self) -> Option<NodePath>

The selected path.

pub fn selected_node_mut( &mut self, ) -> Option<&mut Node<BackendT, ContextT, ErrorT, IdT, DataT>>

The selected node.

pub fn is_selected(&self, row: usize) -> bool

Whether the row is selected.

pub fn select_top(&mut self)

Select top row.

pub fn select_bottom(&mut self)

Select bottom row.

pub fn move_selection(&mut self, delta: isize)

Move selection by delta rows.

impl<BackendT, ContextT, ErrorT, IdT, DataT> TreeView<BackendT, ContextT, ErrorT, IdT, DataT>

pub fn toggle_branch_state( node: &mut Node<BackendT, ContextT, ErrorT, IdT, DataT>, context: ContextT, ) -> EventResult

where BackendT: TreeBackend<ContextT, ErrorT, IdT, DataT>, ContextT: Clone, ErrorT: 'static + Send + Sync,

Toggle branch state.

pub fn expand_branch( node: &mut Node<BackendT, ContextT, ErrorT, IdT, DataT>, context: ContextT, ) -> EventResult

where BackendT: TreeBackend<ContextT, ErrorT, IdT, DataT>, ContextT: Clone, ErrorT: 'static + Send + Sync,

Expand branch.

Trait Implementations

impl<BackendT, ContextT, ErrorT, IdT, DataT> From<TreeModel<BackendT, ContextT, ErrorT, IdT, DataT>> for TreeView<BackendT, ContextT, ErrorT, IdT, DataT>

fn from(model: TreeModel<BackendT, ContextT, ErrorT, IdT, DataT>) -> Self

Converts to this type from the input type.

impl<BackendT, ContextT, ErrorT, IdT, DataT> View for TreeView<BackendT, ContextT, ErrorT, IdT, DataT>

where BackendT: 'static + TreeBackend<ContextT, ErrorT, IdT, DataT> + Send + Sync, ContextT: 'static + Clone + Send + Sync, ErrorT: 'static + Send + Sync, IdT: 'static + Send + Sync, DataT: 'static + Send + Sync,

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

Returns the type of this view.

fn take_focus(&mut self, _source: Direction) -> Result<EventResult, CannotFocus>

Attempt to give this view the focus.

fn required_size(&mut self, _constraint: XY<usize>) -> XY<usize>

Returns the minimum size the view requires with the given restrictions.

fn important_area(&self, view_size: XY<usize>) -> Rect

What part of the view is important and should be visible?

fn on_event(&mut self, event: Event) -> EventResult

Called when an event is received (key press, mouse event, …).

fn draw(&self, printer: &Printer<'_, '_>)

Draws the view with the given printer (includes bounds) and focus.

fn layout(&mut self, _: XY<usize>)

Called once the size for this view has been decided.

fn needs_relayout(&self) -> bool

Should return true if the view content changed since the last call to layout().

fn call_on_any( &mut self, _: &Selector<'_>, _: &mut dyn FnMut(&mut (dyn View + 'static)), )

Runs a closure on the view identified by the given selector.

fn focus_view(&mut self, _: &Selector<'_>) -> Result<EventResult, ViewNotFound>

Moves the focus to the view identified by the given selector.