Struct cursive::view::scroll::Core

pub struct Core { /* fields omitted */ }

Core system for scrolling views.

This is the lowest-level element handling scroll logic.

Higher-level abstractions are probably what you're after.

In particular, see also ScrollView.

Implementations

impl Core

pub fn new() -> Core

Creates a new Core.

pub fn sub_printer(&self, printer: &Printer<'a, 'b>) -> Printer<'a, 'b>

Returns a sub-printer ready to draw the content.

pub fn is_event_inside(&self, event: &mut Event) -> bool

Returns true if event should be processed by the content.

This also updates event so that it is relative to the content.

pub fn on_inner_event(
    &mut self,
    event: Event,
    inner_result: EventResult,
    important_area: Rect
) -> EventResult

Handle an event after processing by the content.

pub fn last_size(&self) -> XY<usize>

Returns the size last given in set_last_size().

pub fn needs_relayout(&self) -> bool

Returns true if we should relayout, no matter the content.

Even if this returns false, the content itself might still needs to relayout.

pub fn call_on_any<F>(
    &mut self,
    selector: &Selector,
    cb: &'a mut (dyn FnMut(&mut (dyn View + 'static)) + 'a),
    inner_call_on_any: F
) where
    F: FnOnce(&Selector, &mut dyn FnMut(&mut (dyn View + 'static))), 

Performs View::call_on_any()

pub fn focus_view<F>(
    &mut self,
    selector: &Selector,
    inner_focus_view: F
) -> Result<(), ()> where
    F: FnOnce(&Selector) -> Result<(), ()>, 

Performs View::focus_view()

pub fn content_viewport(&self) -> Rect

Returns the viewport in the inner content.

pub fn set_scroll_strategy(&mut self, strategy: ScrollStrategy)

Defines the way scrolling is adjusted on content or size change.

The scroll strategy defines how the scrolling position is adjusted when the size of the view or the content change.

It is reset to ScrollStrategy::KeepRow whenever the user scrolls manually.

pub fn scroll_strategy(self, strategy: ScrollStrategy) -> Core

Defines the way scrolling is adjusted on content or size change.

Chainable variant.

pub fn set_scrollbar_padding<V>(&mut self, scrollbar_padding: V) where
    V: Into<XY<usize>>, 

Sets the padding between content and scrollbar.

pub fn scrollbar_padding<V>(self, scrollbar_padding: V) -> Core where
    V: Into<XY<usize>>, 

Sets the padding between content and scrollbar.

Chainable variant.

pub fn get_scrollbar_padding(&self) -> XY<usize>

Returns the padding between content and scrollbar.

pub fn is_enabled(&self) -> XY<bool>

For each axis, returns true if this view can scroll.

For example, a vertically-scrolling view will return XY { x: false, y: true }.

pub fn set_show_scrollbars(&mut self, show_scrollbars: bool)

Control whether scroll bars are visibile.

Defaults to true.

pub fn show_scrollbars(self, show_scrollbars: bool) -> Core

Control whether scroll bars are visibile.

Chainable variant

pub fn get_show_scrollbars(&self) -> bool

Returns true if we will show scrollbars when needed.

Scrollbars are always hidden when not needed.

pub fn inner_size(&self) -> XY<usize>

Returns the size given to the content on the last layout phase.

pub fn set_offset<S>(&mut self, offset: S) where
    S: Into<XY<usize>>, 

Sets the scroll offset to the given value

pub fn set_scroll_y(&mut self, enabled: bool)

Controls whether this view can scroll vertically.

Defaults to true.

pub fn set_scroll_x(&mut self, enabled: bool)

Controls whether this view can scroll horizontally.

Defaults to false.

pub fn scroll_y(self, enabled: bool) -> Core

Controls whether this view can scroll vertically.

Defaults to true.

Chainable variant.

pub fn scroll_x(self, enabled: bool) -> Core

Controls whether this view can scroll horizontally.

Defaults to false.

Chainable variant.

pub fn keep_in_view(&mut self, rect: Rect)

Try to keep the given rect in view.

pub fn scroll_to_rect(&mut self, important_area: Rect)

Scrolls until the given rect is in view.

pub fn scroll_to(&mut self, pos: XY<usize>)

Scroll until the given point is visible.

pub fn scroll_to_x(&mut self, x: usize)

Scroll until the given column is visible.

pub fn scroll_to_y(&mut self, y: usize)

Scroll until the given row is visible.

pub fn scroll_to_top(&mut self)

Programmatically scroll to the top of the view.

pub fn scroll_to_bottom(&mut self)

Programmatically scroll to the bottom of the view.

pub fn scroll_to_left(&mut self)

Programmatically scroll to the leftmost side of the view.

pub fn scroll_to_right(&mut self)

Programmatically scroll to the rightmost side of the view.

pub fn is_scrolling(&self) -> XY<bool>

Returns for each axis if we are scrolling.

pub fn scrollbar_size(&self) -> XY<usize>

Returns the size taken by the scrollbars.

Will be zero in axis where we're not scrolling.

The scrollbar_size().x will be the horizontal space taken by the vertical scrollbar.

Trait Implementations

impl Debug for Core

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

Formats the value using the given formatter.

impl Default for Core

fn default() -> Core

Returns the "default value" for a type.