Skip to main content

GridView

Struct GridView 

Source
pub struct GridView { /* private fields */ }
Expand description

A scrolling grid of cells of one size, in as many columns as fit its width and at least one, for app and wallpaper pickers. It builds only the rows of cells in view, so a grid of thousands costs what a screenful does, and follows a list of items as children_keyed does: each cell is kept while its item’s key stays in the list. When its width changes the number of columns, the cell at the top left stays in view.

use crabshell_ui::{GridView, Icon};

let apps = GridView::new(
    || vec!["firefox", "foot", "gimp"],
    |name| *name,
    |_cx, name| Icon::new(name.get()).size(48),
)
.cell_size(72, 72)
.height(288);

Implementations§

Source§

impl GridView

Source

pub const DEFAULT_CELL: u32 = 100

The default cell width and height, in logical pixels, as Qt’s.

Source

pub const DEFAULT_HEIGHT: u32 = 240

The default height of the grid, in logical pixels.

Source

pub fn new<T, K, W>( items: impl FnMut() -> Vec<T> + 'static, key: impl FnMut(&T) -> K + 'static, view: impl FnMut(&Cx, Memo<T>) -> W + 'static, ) -> GridView
where T: Clone + PartialEq + 'static, K: Eq + Hash + 'static, W: Widget,

A grid with a cell for each of items, built by view and kept by key, as in children_keyed.

Source

pub fn cell_size( self, width: impl IntoProp<u32>, height: impl IntoProp<u32>, ) -> GridView

Sets every cell’s width and height in logical pixels, 100 by default. A cell’s content is laid out in that box; a size of 0 counts as 1.

Source

pub fn height(self, height: impl IntoProp<u32>) -> GridView

Sets the grid’s height in logical pixels. Its width comes from its style or its parent.

Source

pub fn current(self, index: impl IntoProp<Option<usize>>) -> GridView

Keeps the cell at this index in view, scrolling as little as needed whenever it, the height or the number of columns changes. An index past the end is scrolled to once the items reach it; None scrolls nothing. While the grid moves, a change scrolls nothing, as in ListView::current.

Source

pub fn highlight(self, style: impl IntoProp<Option<Style>>) -> GridView

Draws a box in this style behind the current cell, as ListView::highlight does.

Source

pub fn offset(self, offset: Signal<f32>) -> GridView

Shares the offset, as ScrollView::offset does.

Source

pub fn kinetic(self, kinetic: impl IntoProp<bool>) -> GridView

Keeps the grid moving after a fling, as ScrollView::kinetic does. On by default.

Source

pub fn overshoot(self, overshoot: impl IntoProp<bool>) -> GridView

Lets the grid go past its ends, as ScrollView::overshoot does. On by default.

Source

pub fn scroll_bar(self, style: impl IntoProp<Option<Style>>) -> GridView

Draws a scroll bar, as ScrollView::scroll_bar does.

Source

pub fn style(self, style: impl IntoProp<Style>) -> GridView

Sets the grid’s style.

Source

pub fn visible(self, visible: impl IntoProp<bool>) -> Self

Shows or hides the widget. Hidden, it is taken out of the layout, so its space goes to the others, and it isn’t drawn, hit or reached by Tab; it drops the keyboard focus and the pointer. Its bindings and state stay, so it shows again as it was. Shown by default.

Source

pub fn geometry(self, geometry: Signal<Rect>) -> Self

Shares where the widget is: after each layout that moves or resizes it, its laid-out rectangle in the window’s logical pixels, scrolled with any scroll view around it but not moved by a style’s translate, scale or rotate, is written to geometry. A hidden widget writes nothing. An effect that reads it may change the layout: the window is laid out again at once, until nothing moves.

Trait Implementations§

Source§

impl Widget for GridView

Source§

fn into_element(self: Box<Self>) -> Element

Turns the description, and everything inside it, into the element the window builds nodes from. It runs when the window is created or a list item first appears, before the window’s tree is touched and without recording what it reads, so it only describes.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more