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 horizontal(self, horizontal: impl IntoProp<bool>) -> GridView

Fills each column top to bottom, then the next, and scrolls sideways, as Qt’s GridView.FlowTopToBottom. height then means the grid’s width, its height comes from its style or its parent, and a column holds as many cells as fit it, at least one. current, the highlight and the offset go along the columns. Off by default.

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, or its width in a horizontal grid. The other side 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 mouse_drag(self, mouse_drag: impl IntoProp<bool>) -> GridView

Lets a mouse drag the grid’s cells, as ScrollView::mouse_drag 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.

Source

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

Shares where the widget is drawn: the box around it once its own and its ancestors’ translate, scale and rotate have moved it, in the window’s logical pixels, scrolled with any scroll view around it. It is written after each layout that moves it and after each change of a transform or an offset that does, every frame of an animated one. A hidden widget writes nothing. Where the window itself is on its output is unknown: Wayland doesn’t tell a client.

Source

pub fn accessible_name(self, name: impl IntoProp<String>) -> Self

What a screen reader calls the widget, instead of what it shows: a button’s text, a text’s own, or a field’s placeholder. An icon button needs one to be read at all.

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