Struct kas_widgets::Grid
source · pub struct Grid<W: Widget> { /* private fields */ }
Expand description
A generic grid widget
Child widgets are displayed in a grid, according to each child’s
GridChildInfo
. This allows spans and overlapping widgets. The numbers
of rows and columns is determined automatically while the sizes of rows and
columns are determined based on their contents (including special handling
for spans, mostly with good results).
Note that all child widgets are stored in a list internally. The order of widgets in that list does not affect display position, but does have a few effects: (a) widgets may be accessed in this order via indexing, (b) widgets are configured and drawn in this order, (c) navigating through widgets with the Tab key currently uses the list order (though it may be changed in the future to use display order).
There is no protection against multiple widgets occupying the same cell. If this does happen, the last widget in that cell will appear on top, but overlapping widget drawing may not be pretty.
Alternatives
Where the entries are fixed, also consider custom Widget
implementations.
Performance
Most operations are O(n)
in the number of children.
Messages
If a handler is specified via Self::on_messages
then this handler is
called when a child pushes a message.
Implementations§
source§impl<W: Widget> Grid<W>
impl<W: Widget> Grid<W>
sourcepub fn new_vec(widgets: Vec<(GridChildInfo, W)>) -> Self
pub fn new_vec(widgets: Vec<(GridChildInfo, W)>) -> Self
Construct a new instance
sourcepub fn map_message<M, N, H>(self, handler: H) -> Self
pub fn map_message<M, N, H>(self, handler: H) -> Self
Add a child handler to map messages of type M
to N
Example
use kas::messages::Select;
use kas_widgets::{Row, Tab};
#[derive(Clone, Debug)]
struct MsgSelectIndex(usize);
let tabs: Row<Tab> = Row::new([]).map_message(|index, Select| MsgSelectIndex(index));
sourcepub fn on_message<M, H>(self, handler: H) -> Self
pub fn on_message<M, H>(self, handler: H) -> Self
Add a child handler for messages of type M
Where multiple message types must be handled or access to the
AdaptEventCx
is required, use Self::on_messages
instead.
sourcepub fn on_messages<H>(self, handler: H) -> Self
pub fn on_messages<H>(self, handler: H) -> Self
Add a child message handler (inline style)
This handler is called when a child pushes a message:
f(cx, index)
, where index
is the child’s index.
sourcepub fn dimensions(&self) -> GridDimensions
pub fn dimensions(&self) -> GridDimensions
Get grid dimensions
The numbers of rows, columns and spans is determined automatically.
sourcepub fn layout_storage(&mut self) -> &mut impl GridStorage
pub fn layout_storage(&mut self) -> &mut impl GridStorage
Access layout storage
Use Self::dimensions
to get expected dimensions.
sourcepub fn edit<F: FnOnce(GridBuilder<'_, W>)>(&mut self, f: F) -> Action
pub fn edit<F: FnOnce(GridBuilder<'_, W>)>(&mut self, f: F) -> Action
Edit an existing grid via a builder
This may be used to edit children before window construction. It may
also be used from a running UI, but in this case a full reconfigure
of the window’s widgets is required (triggered by the the return
value, Action::RECONFIGURE
).
sourcepub fn get_mut(&mut self, index: usize) -> Option<&mut W>
pub fn get_mut(&mut self, index: usize) -> Option<&mut W>
Returns a mutable reference to the child, if any
sourcepub fn iter(&self) -> impl Iterator<Item = &(GridChildInfo, W)>
pub fn iter(&self) -> impl Iterator<Item = &(GridChildInfo, W)>
Iterate over childern
sourcepub fn iter_mut(&mut self) -> impl Iterator<Item = &mut (GridChildInfo, W)>
pub fn iter_mut(&mut self) -> impl Iterator<Item = &mut (GridChildInfo, W)>
Mutably iterate over childern
Trait Implementations§
source§impl<W: Widget> Events for Grid<W>
impl<W: Widget> Events for Grid<W>
source§fn handle_messages(&mut self, cx: &mut EventCx<'_>, data: &Self::Data)
fn handle_messages(&mut self, cx: &mut EventCx<'_>, data: &Self::Data)
source§fn steal_event(
&mut self,
_: &mut EventCx<'_>,
_: &Self::Data,
_: &Id,
_: &Event
) -> IsUsed
fn steal_event( &mut self, _: &mut EventCx<'_>, _: &Self::Data, _: &Id, _: &Event ) -> IsUsed
source§fn configure_recurse(&mut self, cx: &mut ConfigCx<'_>, data: &Self::Data)
fn configure_recurse(&mut self, cx: &mut ConfigCx<'_>, data: &Self::Data)
source§fn update(&mut self, cx: &mut ConfigCx<'_>, data: &Self::Data)
fn update(&mut self, cx: &mut ConfigCx<'_>, data: &Self::Data)
source§fn update_recurse(&mut self, cx: &mut ConfigCx<'_>, data: &Self::Data)
fn update_recurse(&mut self, cx: &mut ConfigCx<'_>, data: &Self::Data)
source§impl<W: Widget> FromIterator<(GridChildInfo, W)> for Grid<W>
impl<W: Widget> FromIterator<(GridChildInfo, W)> for Grid<W>
source§fn from_iter<T>(iter: T) -> Selfwhere
T: IntoIterator<Item = (GridChildInfo, W)>,
fn from_iter<T>(iter: T) -> Selfwhere
T: IntoIterator<Item = (GridChildInfo, W)>,
source§impl<W: Widget> Layout for Grid<W>
impl<W: Widget> Layout for Grid<W>
source§fn num_children(&self) -> usize
fn num_children(&self) -> usize
source§fn get_child(&self, index: usize) -> Option<&dyn Layout>
fn get_child(&self, index: usize) -> Option<&dyn Layout>
dyn Layout
Read moresource§fn size_rules(&mut self, sizer: SizeCx<'_>, axis: AxisInfo) -> SizeRules
fn size_rules(&mut self, sizer: SizeCx<'_>, axis: AxisInfo) -> SizeRules
source§fn widget_name(&self) -> &'static str
fn widget_name(&self) -> &'static str
source§fn find_child_index(&self, id: &Id) -> Option<usize>
fn find_child_index(&self, id: &Id) -> Option<usize>
id
, if any Read moresource§fn translation(&self) -> Offset
fn translation(&self) -> Offset
Auto Trait Implementations§
impl<W> !RefUnwindSafe for Grid<W>
impl<W> !Send for Grid<W>
impl<W> !Sync for Grid<W>
impl<W> Unpin for Grid<W>where
W: Unpin,
impl<W> !UnwindSafe for Grid<W>
Blanket Implementations§
source§impl<W> AdaptWidget for Wwhere
W: Widget,
impl<W> AdaptWidget for Wwhere
W: Widget,
source§fn on_configure<F>(self, f: F) -> AdaptEvents<Self>
fn on_configure<F>(self, f: F) -> AdaptEvents<Self>
Events::configure
Read moresource§fn on_update<F>(self, f: F) -> AdaptEvents<Self>
fn on_update<F>(self, f: F) -> AdaptEvents<Self>
Events::update
Read moresource§fn on_message<M, H>(self, handler: H) -> AdaptEvents<Self>
fn on_message<M, H>(self, handler: H) -> AdaptEvents<Self>
M
Read moresource§fn on_messages<H>(self, handler: H) -> AdaptEvents<Self>
fn on_messages<H>(self, handler: H) -> AdaptEvents<Self>
source§fn with_min_size_px(self, w: i32, h: i32) -> Reserve<Self>
fn with_min_size_px(self, w: i32, h: i32) -> Reserve<Self>
source§fn with_min_size_em(self, w: f32, h: f32) -> Reserve<Self>
fn with_min_size_em(self, w: f32, h: f32) -> Reserve<Self>
source§fn with_label<D, T>(self, direction: D, label: T) -> WithLabel<Self, D>
fn with_label<D, T>(self, direction: D, label: T) -> WithLabel<Self, D>
source§impl<W> AdaptWidgetAny for W
impl<W> AdaptWidgetAny for W
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<S, T> Cast<T> for Swhere
T: Conv<S>,
impl<S, T> Cast<T> for Swhere
T: Conv<S>,
§impl<S, T> CastApprox<T> for Swhere
T: ConvApprox<S>,
impl<S, T> CastApprox<T> for Swhere
T: ConvApprox<S>,
§fn try_cast_approx(self) -> Result<T, Error>
fn try_cast_approx(self) -> Result<T, Error>
§fn cast_approx(self) -> T
fn cast_approx(self) -> T
§impl<S, T> CastFloat<T> for Swhere
T: ConvFloat<S>,
impl<S, T> CastFloat<T> for Swhere
T: ConvFloat<S>,
§fn cast_trunc(self) -> T
fn cast_trunc(self) -> T
§fn cast_nearest(self) -> T
fn cast_nearest(self) -> T
§fn cast_floor(self) -> T
fn cast_floor(self) -> T
§fn try_cast_trunc(self) -> Result<T, Error>
fn try_cast_trunc(self) -> Result<T, Error>
§fn try_cast_nearest(self) -> Result<T, Error>
fn try_cast_nearest(self) -> Result<T, Error>
§fn try_cast_floor(self) -> Result<T, Error>
fn try_cast_floor(self) -> Result<T, Error>
§fn try_cast_ceil(self) -> Result<T, Error>
fn try_cast_ceil(self) -> Result<T, Error>
source§impl<W> LayoutExt for W
impl<W> LayoutExt for W
source§fn identify(&self) -> IdentifyWidget<'_>
fn identify(&self) -> IdentifyWidget<'_>
source§fn is_strict_ancestor_of(&self, id: &Id) -> bool
fn is_strict_ancestor_of(&self, id: &Id) -> bool
id
is not self and is a descendant Read more