Struct TableVecState 

pub struct TableVecState<T, Selection = RowSelection> {
    pub table: TableState<Selection>,
    pub data: Vec<T>,
    pub non_exhaustive: NonExhaustive,
}

State for TableVec.

Fields

table: TableState<Selection>

data: Vec<T>

non_exhaustive: NonExhaustive

Implementations

impl<T, Selection> TableVecState<T, Selection>

where Selection: Default,

pub fn new() -> TableVecState<T, Selection>

pub fn named(name: &str) -> TableVecState<T, Selection>

pub fn with( self, data: impl IntoIterator<Item = T>, ) -> TableVecState<T, Selection>

Populate the table-data.

impl<T, Selection> TableVecState<T, Selection>

pub fn rows(&self) -> usize

Number of rows.

pub fn columns(&self) -> usize

Number of columns.

impl<T, Selection> TableVecState<T, Selection>

pub fn row_cells(&self, row: usize) -> Option<(Rect, Vec<Rect>)>

Returns the whole row-area and the cell-areas for the given row, if it is visible.

Attention: These areas might be 0-length if the column is scrolled beyond the table-area.

pub fn cell_at_clicked(&self, pos: (u16, u16)) -> Option<(usize, usize)>

Cell at given position.

pub fn column_at_clicked(&self, pos: (u16, u16)) -> Option<usize>

Column at given position.

pub fn row_at_clicked(&self, pos: (u16, u16)) -> Option<usize>

Row at given position.

pub fn cell_at_drag(&self, pos: (u16, u16)) -> (usize, usize)

Cell when dragging. Position can be outside the table area. See row_at_drag, col_at_drag

pub fn row_at_drag(&self, pos: (u16, u16)) -> usize

Row when dragging. Position can be outside the table area. If the position is above the table-area this returns offset - #rows. If the position is below the table-area this returns offset + page_len + #rows.

This doesn’t account for the row-height of the actual rows outside the table area, just assumes ‘1’.

pub fn column_at_drag(&self, pos: (u16, u16)) -> usize

Column when dragging. Position can be outside the table area. If the position is left of the table area this returns offset - 1. If the position is right of the table area this returns offset + page_width + 1.

impl<T, Selection> TableVecState<T, Selection>

where Selection: TableSelection,

pub fn clear_offset(&mut self)

Sets both offsets to 0.

pub fn row_max_offset(&self) -> usize

Maximum offset that is accessible with scrolling.

This is shorter than the length by whatever fills the last page. This is the base for the scrollbar content_length.

pub fn row_offset(&self) -> usize

Current vertical offset.

pub fn set_row_offset(&mut self, offset: usize) -> bool

Change the vertical offset. The offset may be beyond the number of rows.

The widget returns true if the offset changed at all.

pub fn page_len(&self) -> usize

Vertical page-size at the current offset.

pub fn row_scroll_by(&self) -> usize

Suggested scroll per scroll-event.

pub fn x_max_offset(&self) -> usize

Maximum offset that is accessible with scrolling.

This is shorter than the length of the content by whatever fills the last page. This is the base for the scrollbar content_length.

pub fn x_offset(&self) -> usize

Current horizontal offset.

pub fn set_x_offset(&mut self, offset: usize) -> bool

Change the horizontal offset. The offset may be beyond the table-width.

Returns true if the offset changed at all.

pub fn page_width(&self) -> usize

Horizontal page-size at the current offset.

pub fn x_scroll_by(&self) -> usize

Suggested scroll per scroll-event.

pub fn scroll_to_selected(&mut self) -> bool

Ensures that the selected item is visible. Caveat: This doesn’t work nicely if you have varying row-heights. Caveat: Number of rows needs to be correct.

pub fn scroll_to_row(&mut self, pos: usize) -> bool

Ensures that the given row is visible. Caveat: This doesn’t work nicely if you have varying row-heights. Caveat: Number of rows needs to be correct.

pub fn scroll_to_col(&mut self, pos: usize) -> bool

Ensures that the given column is completely visible.

pub fn scroll_to_x(&mut self, pos: usize) -> bool

Ensures that the given position is visible.

pub fn scroll_up(&mut self, n: usize) -> bool

Reduce the row-offset by n.

pub fn scroll_down(&mut self, n: usize) -> bool

Increase the row-offset by n.

pub fn scroll_left(&mut self, n: usize) -> bool

Reduce the col-offset by n.

pub fn scroll_right(&mut self, n: usize) -> bool

Increase the col-offset by n.

impl<T, Selection> TableVecState<T, Selection>

where Selection: TableSelection,

pub fn clear_selection(&mut self)

Clear the selection.

impl<T, Selection> TableVecState<T, Selection>

where Selection: TableSelection,

pub fn clear(&mut self)

Clear

pub fn rows_changed(&mut self)

Data-vec changed.

pub fn set_value(&mut self, data: Vec<T>)

Set the data-vec.

pub fn value(&self) -> &Vec<T>

Get the table data.

pub fn append_row(&mut self, value: T)

Add a row to the internal data-vec.

pub fn insert_row(&mut self, row: usize, value: T)

Insert a row to the internal data-vec.

pub fn remove_row(&mut self, row: usize) -> T

Remove a row from the internal data-vec.

impl<T> TableVecState<T>

pub fn set_scroll_selection(&mut self, scroll: bool)

When scrolling the table, change the selection instead of the offset.

pub fn has_selection(&mut self) -> bool

Anything selected?

pub fn selected(&self) -> Option<usize>

Selected row. The selected row is not constrained by the row-count.

pub fn selected_checked(&self) -> Option<usize>

Return the selected row and ensure it is in the range 0..rows.

pub fn select(&mut self, row: Option<usize>) -> bool

Select the row. The selection is not constrained by the row-count.

pub fn move_deselect(&mut self) -> bool

Set the selection to None and set the offset to 0

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

Move the selection to the given row. Ensures the row is visible afterward.

pub fn move_up(&mut self, n: usize) -> bool

Move the selection up n rows. Ensures the row is visible afterward.

pub fn move_down(&mut self, n: usize) -> bool

Move the selection down n rows. Ensures the row is visible afterward.

impl<T> TableVecState<T, RowSetSelection>

pub fn has_selection(&mut self) -> bool

Anything selected?

pub fn selected(&self) -> HashSet<usize>

Selected rows.

pub fn set_lead(&mut self, row: Option<usize>, extend: bool) -> bool

Change the lead-selection. Limits the value to the number of rows. If extend is false the current selection is cleared and both lead and anchor are set to the given value. If extend is true, the anchor is kept where it is and lead is changed. Everything in the range anchor..lead is selected. It doesn’t matter if anchor < lead.

pub fn lead(&self) -> Option<usize>

Current lead.

pub fn anchor(&self) -> Option<usize>

Current anchor.

pub fn retire_selection(&mut self)

Retire the current anchor/lead selection to the set of selected rows. Resets lead and anchor and starts a new selection round.

pub fn add_selected(&mut self, idx: usize)

Add to selection. Only works for retired selections, not for the active anchor-lead range.

To be sure call retire_selection first.

pub fn remove_selected(&mut self, idx: usize)

Remove from selection. Only works for retired selections, not for the active anchor-lead range.

To be sure call retire_selection first.

pub fn move_to(&mut self, row: usize, extend: bool) -> bool

Move the selection to the given row. Ensures the row is visible afterward.

pub fn move_up(&mut self, n: usize, extend: bool) -> bool

Move the selection up n rows. Ensures the row is visible afterward.

pub fn move_down(&mut self, n: usize, extend: bool) -> bool

Move the selection down n rows. Ensures the row is visible afterwards.

impl<T> TableVecState<T, CellSelection>

pub fn has_selection(&mut self) -> bool

pub fn selected(&self) -> Option<(usize, usize)>

Selected cell.

pub fn select_cell(&mut self, select: Option<(usize, usize)>) -> bool

Select a cell.

pub fn select_row(&mut self, row: Option<usize>) -> bool

Select a row. Column stays the same.

pub fn select_column(&mut self, column: Option<usize>) -> bool

Select a column, row stays the same.

pub fn move_to(&mut self, select: (usize, usize)) -> bool

Select a cell, limit to maximum.

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

Select a row, limit to maximum.

pub fn move_to_col(&mut self, col: usize) -> bool

Select a cell, clamp between 0 and maximum.

pub fn move_up(&mut self, n: usize) -> bool

Move the selection up n rows. Ensures the row is visible afterwards.

pub fn move_down(&mut self, n: usize) -> bool

Move the selection down n rows. Ensures the row is visible afterwards.

pub fn move_left(&mut self, n: usize) -> bool

Move the selection left n columns. Ensures the row is visible afterwards.

pub fn move_right(&mut self, n: usize) -> bool

Move the selection right n columns. Ensures the row is visible afterwards.

Trait Implementations

impl<T, Selection> Clone for TableVecState<T, Selection>

where T: Clone, Selection: Clone,

fn clone(&self) -> TableVecState<T, Selection>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T, Selection> Default for TableVecState<T, Selection>

where Selection: Default,

fn default() -> TableVecState<T, Selection>

Returns the “default value” for a type.

impl<T, Selection> HandleEvent<Event, DoubleClick, DoubleClickOutcome> for TableVecState<T, Selection>

fn handle(&mut self, event: &Event, _keymap: DoubleClick) -> DoubleClickOutcome

Handles double-click events on the table.

impl<T> HandleEvent<Event, MouseOnly, TableOutcome> for TableVecState<T, CellSelection>

fn handle(&mut self, event: &Event, _: MouseOnly) -> TableOutcome

Handle an event.

impl<T> HandleEvent<Event, MouseOnly, TableOutcome> for TableVecState<T, NoSelection>

fn handle(&mut self, event: &Event, _: MouseOnly) -> TableOutcome

Handle an event.

impl<T> HandleEvent<Event, MouseOnly, TableOutcome> for TableVecState<T>

fn handle(&mut self, event: &Event, _: MouseOnly) -> TableOutcome

Handle an event.

impl<T> HandleEvent<Event, MouseOnly, TableOutcome> for TableVecState<T, RowSetSelection>

fn handle(&mut self, event: &Event, _: MouseOnly) -> TableOutcome

Handle an event.

impl<T> HandleEvent<Event, Regular, TableOutcome> for TableVecState<T, CellSelection>

fn handle(&mut self, event: &Event, _: Regular) -> TableOutcome

Handle an event.

impl<T> HandleEvent<Event, Regular, TableOutcome> for TableVecState<T, NoSelection>

fn handle(&mut self, event: &Event, _: Regular) -> TableOutcome

Handle an event.

impl<T> HandleEvent<Event, Regular, TableOutcome> for TableVecState<T>

fn handle(&mut self, event: &Event, _: Regular) -> TableOutcome

Handle an event.

impl<T> HandleEvent<Event, Regular, TableOutcome> for TableVecState<T, RowSetSelection>

fn handle(&mut self, event: &Event, _: Regular) -> TableOutcome

Handle an event.

impl<T, Selection> HasFocus for TableVecState<T, Selection>

fn build(&self, builder: &mut FocusBuilder)

Build the focus-structure for the container/widget.

fn focus(&self) -> FocusFlag

Access to the focus flag.

fn area(&self) -> Rect

Area for mouse focus.

fn build_nav(&self, navigable: Navigation, builder: &mut FocusBuilder)

Build the focus-structure for the container/widget.

fn id(&self) -> usize

Provide a unique id for the widget.

fn area_z(&self) -> u16

Z-value for the area.

fn navigable(&self) -> Navigation

Declares how the widget interacts with focus.

fn is_focused(&self) -> bool

Does this widget have the focus or if the flag is used for a container, does any of widgets inside the container have the focus.

fn lost_focus(&self) -> bool

This widget just lost the focus.

fn gained_focus(&self) -> bool

This widget just gained the focus.

fn is_obscured(&self) -> bool

This widget is not beneath the mouse-cursor.

impl<T, Selection> HasScreenCursor for TableVecState<T, Selection>

fn screen_cursor(&self) -> Option<(u16, u16)>

This returns the cursor position if

impl<T, Selection> RelocatableState for TableVecState<T, Selection>

fn relocate(&mut self, shift: (i16, i16), clip: Rect)

Relocate the areas in this widgets state.

fn relocate_popup(&mut self, shift: (i16, i16), clip: Rect)

Relocate only popup areas. As rendering the popups is a separate render, this has to be separate too.

fn relocate_popup_hidden(&mut self)

Relocate all popup areas to a clip-rect (0,0+0x0).

fn relocate_hidden(&mut self)

Relocate all areas to a clip-rect (0,0+0x0).