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
impl GridView
Sourcepub const DEFAULT_CELL: u32 = 100
pub const DEFAULT_CELL: u32 = 100
The default cell width and height, in logical pixels, as Qt’s.
Sourcepub const DEFAULT_HEIGHT: u32 = 240
pub const DEFAULT_HEIGHT: u32 = 240
The default height of the grid, in logical pixels.
Sourcepub 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
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
A grid with a cell for each of items, built by view and kept by
key, as in children_keyed.
Sourcepub fn cell_size(
self,
width: impl IntoProp<u32>,
height: impl IntoProp<u32>,
) -> GridView
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.
Sourcepub fn height(self, height: impl IntoProp<u32>) -> GridView
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.
Sourcepub fn current(self, index: impl IntoProp<Option<usize>>) -> GridView
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.
Sourcepub fn highlight(self, style: impl IntoProp<Option<Style>>) -> GridView
pub fn highlight(self, style: impl IntoProp<Option<Style>>) -> GridView
Draws a box in this style behind the current
cell, as ListView::highlight does.
Sourcepub fn offset(self, offset: Signal<f32>) -> GridView
pub fn offset(self, offset: Signal<f32>) -> GridView
Shares the offset, as ScrollView::offset does.
Sourcepub fn kinetic(self, kinetic: impl IntoProp<bool>) -> GridView
pub fn kinetic(self, kinetic: impl IntoProp<bool>) -> GridView
Keeps the grid moving after a fling, as ScrollView::kinetic
does. On by default.
Sourcepub fn overshoot(self, overshoot: impl IntoProp<bool>) -> GridView
pub fn overshoot(self, overshoot: impl IntoProp<bool>) -> GridView
Lets the grid go past its ends, as ScrollView::overshoot does.
On by default.
Sourcepub fn scroll_bar(self, style: impl IntoProp<Option<Style>>) -> GridView
pub fn scroll_bar(self, style: impl IntoProp<Option<Style>>) -> GridView
Draws a scroll bar, as ScrollView::scroll_bar does.
Sourcepub fn visible(self, visible: impl IntoProp<bool>) -> Self
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.
Sourcepub fn geometry(self, geometry: Signal<Rect>) -> Self
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.