Struct rat_widget::scrolled::ScrollState

pub struct ScrollState {
    pub area: Rect,
    pub core: ScrollCore,
    pub mouse: MouseFlags,
    pub non_exhaustive: NonExhaustive,
}

Holds the Scrolled-State.

The current visible page is represented as the pair (offset, page_len). The limit for scrolling is given as max_offset, which is the maximum offset where a full page can still be displayed. Note that the total length of the widgets data is NOT max_offset + page_len. The page_len can be different for every offset selected. Only if the offset is set to max_offset and after the next round of rendering len == max_offset + page_len will hold true.

Fields

area: Rect

core: ScrollCore

mouse: MouseFlags

non_exhaustive: NonExhaustive

Implementations

impl ScrollState

pub fn new() -> ScrollState

pub fn offset(&self) -> usize

Current vertical offset.

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

Change the offset. Limits the offset to max_v_offset + v_overscroll.

Due to overscroll it’s possible that this is an invalid offset for the widget. The widget must deal with this situation.

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

Scroll to row.

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

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

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

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

pub fn limit_offset(&self, offset: usize) -> usize

Calculate the offset limited to max_offset+overscroll_by.

pub fn 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 set_max_offset(&mut self, max: 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 page_len(&self) -> usize

Page-size at the current offset.

pub fn set_page_len(&mut self, page: usize)

Page-size at the current offset.

pub fn scroll_by(&self) -> usize

Suggested scroll per scroll-event. Defaults to 1/10 of the page

pub fn set_scroll_by(&mut self, scroll: Option<usize>)

Suggested scroll per scroll-event. Defaults to 1/10 of the page

Trait Implementations

impl Clone for ScrollState

fn clone(&self) -> ScrollState

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ScrollState

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

Formats the value using the given formatter.

impl Default for ScrollState

fn default() -> ScrollState

Returns the “default value” for a type.

impl HandleEvent<Event, MouseOnly, ScrollOutcome> for ScrollState

fn handle(&mut self, event: &Event, _qualifier: MouseOnly) -> ScrollOutcome

Handle an event.

impl PartialEq for ScrollState

fn eq(&self, other: &ScrollState) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ScrollState

impl StructuralPartialEq for ScrollState