Struct kas::widgets::ScrollBars

pub struct ScrollBars<W>where
    W: Scrollable,{ /* private fields */ }

Scroll bar controls

This is a wrapper adding scroll bar controls around a child. Note that this widget does not enable scrolling; see ScrollBarRegion for that.

Scroll bar positioning does not respect the inner widgets margins, since the result looks poor when content is scrolled. Instead the content should force internal margins by wrapping contents with a (zero-sized) frame. ScrollRegion already does this.

Implementations

impl<W> ScrollBars<W>where W: Scrollable,

pub fn new(inner: W) -> ScrollBars<W>

Construct

By default scroll bars are automatically enabled based on requirements. Use the HasScrollBars trait to adjust this behaviour.

pub fn inner(&self) -> &W

Access inner widget directly

pub fn inner_mut(&mut self) -> &mut W

Access inner widget directly

Trait Implementations

impl<W> Clone for ScrollBars<W>where W: Clone + Scrollable,

fn clone(&self) -> ScrollBars<W>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<W> Debug for ScrollBars<W>where W: Debug + Scrollable,

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

Formats the value using the given formatter.

impl<W> Default for ScrollBars<W>where W: Scrollable + Default,

fn default() -> ScrollBars<W>

Returns the “default value” for a type.

impl<W> Deref for ScrollBars<W>where W: Scrollable,

type Target = W

The resulting type after dereferencing.

fn deref(&self) -> &<ScrollBars<W> as Deref>::Target

Dereferences the value.

impl<W> DerefMut for ScrollBars<W>where W: Scrollable,

fn deref_mut(&mut self) -> &mut <ScrollBars<W> as Deref>::Target

Mutably dereferences the value.

impl<W> HasBool for ScrollBars<W>where W: Scrollable + HasBool,

fn get_bool(&self) -> bool

Get the widget’s state

fn set_bool(&mut self, state: bool) -> Action

Set the widget’s state

impl<W> HasScrollBars for ScrollBars<W>where W: Scrollable,

fn get_mode(&self) -> ScrollBarMode

Get mode

fn set_mode(&mut self, mode: ScrollBarMode) -> Action

Set mode

fn get_visible_bars(&self) -> (bool, bool)

Get currently visible bars

fn set_visible_bars(&mut self, bars: (bool, bool)) -> Action

Set enabled bars without adjusting mode

fn with_auto_bars(self) -> Selfwhere Self: Sized,

Set auto mode (inline)

fn with_fixed_bars(self, horiz: bool, vert: bool) -> Selfwhere Self: Sized,

Set fixed bars (inline)

fn with_invisible_bars(self, horiz: bool, vert: bool) -> Selfwhere Self: Sized,

Set invisible bars (inline)

impl<W> HasStr for ScrollBars<W>where W: Scrollable + HasStr,

fn get_str(&self) -> &str

Get text by reference

fn get_string(&self) -> String

Get text as a String

impl<W> HasString for ScrollBars<W>where W: Scrollable + HasString,

fn set_str(&mut self, text: &str) -> Action

Set text from a &str

fn set_string(&mut self, text: String) -> Action

Set text from a string

impl<W> Layout for ScrollBars<ScrollRegion<W>>where W: Widget,

fn draw(&mut self, draw: DrawMgr<'_>)

Draw a widget and its children

fn size_rules(&mut self, size_mgr: SizeMgr<'_>, axis: AxisInfo) -> SizeRules

Get size rules for the given axis

fn set_rect(&mut self, mgr: &mut ConfigMgr<'_>, rect: Rect)

Set size and position

fn find_id(&mut self, coord: Coord) -> Option<WidgetId>

Translate a coordinate to a WidgetId

impl<W> Layout for ScrollBars<W>where W: Scrollable,

fn size_rules(&mut self, size_mgr: SizeMgr<'_>, axis: AxisInfo) -> SizeRules

Get size rules for the given axis

fn set_rect(&mut self, mgr: &mut ConfigMgr<'_>, rect: Rect)

Set size and position

fn find_id(&mut self, coord: Coord) -> Option<WidgetId>

Translate a coordinate to a WidgetId

default fn draw(&mut self, draw: DrawMgr<'_>)

Draw a widget and its children

impl<W> Scrollable for ScrollBars<W>where W: Scrollable,

fn scroll_axes(&self, size: Size) -> (bool, bool)

Given size size, returns whether (horiz, vert) scrolling is required

fn max_scroll_offset(&self) -> Offset

Get the maximum scroll offset

fn scroll_offset(&self) -> Offset

Get the current scroll offset

fn set_scroll_offset(&mut self, mgr: &mut EventMgr<'_>, offset: Offset) -> Offset

Set the scroll offset

impl<W> SetAccel for ScrollBars<W>where W: Scrollable + SetAccel,

fn set_accel_string(&mut self, accel: AccelString) -> Action

Set accel string

fn set_accel<T>(&mut self, accel: T) -> Actionwhere T: Into<AccelString>, Self: Sized,

Set text

impl<W> Widget for ScrollBars<W>where W: Scrollable,

fn handle_message(&mut self, mgr: &mut EventMgr<'_>)

Handler for messages from children/descendants

fn handle_scroll(&mut self, mgr: &mut EventMgr<'_>, _: Scroll)

Handler for scrolling

fn pre_configure(&mut self, _: &mut ConfigMgr<'_>, id: WidgetId)

Pre-configuration

fn configure(&mut self, mgr: &mut ConfigMgr<'_>)

Configure widget

fn navigable(&self) -> bool

Is this widget navigable via Tab key?

fn translation(&self) -> Offset

Get translation of children relative to this widget

fn nav_next( &mut self, mgr: &mut ConfigMgr<'_>, reverse: bool, from: Option<usize> ) -> Option<usize>

Navigation in spatial order

fn handle_event(&mut self, mgr: &mut EventMgr<'_>, event: Event) -> Response

Handle an Event sent to this widget

fn steal_event( &mut self, mgr: &mut EventMgr<'_>, id: &WidgetId, event: &Event ) -> Response

Potentially steal an event before it reaches a child

fn handle_unused(&mut self, mgr: &mut EventMgr<'_>, event: Event) -> Response

Handle an event sent to child index but left unhandled

impl<W> WidgetChildren for ScrollBars<W>where W: Scrollable,

fn num_children(&self) -> usize

Get the number of child widgets

fn get_child(&self, _index: usize) -> Option<&dyn Widget>

Get a reference to a child widget by index, or None if the index is out of bounds.

fn get_child_mut(&mut self, _index: usize) -> Option<&mut dyn Widget>

Mutable variant of get

fn find_child_index(&self, id: &WidgetId) -> Option<usize>

Find the child which is an ancestor of this id, if any

fn make_child_id(&mut self, index: usize) -> WidgetId

Make an identifier for a child

impl<W> WidgetCore for ScrollBars<W>where W: Scrollable,

fn id_ref(&self) -> &WidgetId

Get the widget’s identifier

fn rect(&self) -> Rect

Get the widget’s region, relative to its parent.

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

Get the name of the widget struct

fn as_widget(&self) -> &dyn Widget

Erase type

fn as_widget_mut(&mut self) -> &mut dyn Widget

Erase type