pub struct Checkbox { /* private fields */ }Expand description
Copyable declaration for one controlled, unstyled checkbox.
The application owns the checked value, listener, layout, indicator, label, colors, and motion. QuickGUI supplies the checkbox role, exact on/off/mixed state, focus/click behavior, native window-drag exclusion, desktop arrow cursor, and an accessibility-hidden indicator part.
The descriptor retains no allocation, task, timer, observer, or idle scheduler source.
Implementations§
Source§impl Checkbox
impl Checkbox
pub fn new(state: impl Into<ToggleState>) -> Self
Sourcepub fn parent(children: impl IntoIterator<Item = bool>) -> Self
pub fn parent(children: impl IntoIterator<Item = bool>) -> Self
Derive a parent checkbox from the checked values of the boxes it governs.
This is Base UI’s parent checkbox: every child checked reports on, none reports off, and
a mix reports mixed. QuickGUI keeps no child registry — the application passes the values it
is already rendering — so the derivation stays a pure function of the caller’s own data.
use quickgui::{Checkbox, ToggleState};
assert_eq!(Checkbox::parent([true, true]).state(), ToggleState::On);
assert_eq!(Checkbox::parent([false, false]).state(), ToggleState::Off);
assert_eq!(Checkbox::parent([true, false]).state(), ToggleState::Mixed);
// An empty group is unchecked rather than mixed.
assert_eq!(Checkbox::parent([]).state(), ToggleState::Off);Sourcepub const fn read_only(self, read_only: bool) -> Self
pub const fn read_only(self, read_only: bool) -> Self
Show a value the user may read but not change, Base UI’s readOnly.
Unlike a disabled checkbox, a read-only one stays focusable and stays in the Tab sequence.
QuickGUI projects the state and refuses the transition through Self::next_state; the
application’s own listener asks for that transition rather than toggling blindly.
pub const fn state(self) -> ToggleState
pub const fn is_read_only(self) -> bool
Sourcepub const fn next_state(self) -> Option<ToggleState>
pub const fn next_state(self) -> Option<ToggleState>
The state an activation moves this checkbox to, or None when it refuses.
Mixed and off both move to on, and on moves to off, which is the web’s tri-state contract.
A read-only checkbox returns None, so a click listener that asks before writing cannot
change a value the control is refusing.
Sourcepub const fn parent_next_checked(self) -> Option<bool>
pub const fn parent_next_checked(self) -> Option<bool>
The checked value activating a parent checkbox moves its whole group to.
A partially or fully unchecked parent checks everything; a fully checked one clears it.
Returns None when the parent is read-only.
Sourcepub fn root_with(self, root: Element) -> Element
pub fn root_with(self, root: Element) -> Element
Decorate an application-owned root without adding layout or appearance.
Sourcepub fn root(self) -> Element
pub fn root(self) -> Element
Create the unstyled root part. Use Self::root_with to supply an existing element.
Sourcepub fn indicator_with(self, indicator: Element) -> Element
pub fn indicator_with(self, indicator: Element) -> Element
Hide an application-owned visual indicator from the accessible name.
Sourcepub fn indicator(self) -> Element
pub fn indicator(self) -> Element
Create the unstyled indicator part. Use Self::indicator_with to supply an existing element.
Trait Implementations§
impl Copy for Checkbox
impl Eq for Checkbox
impl StructuralPartialEq for Checkbox
Auto Trait Implementations§
impl Forget for Checkbox
impl Freeze for Checkbox
impl Move for Checkbox
impl RefUnwindSafe for Checkbox
impl Send for Checkbox
impl Sync for Checkbox
impl Unpin for Checkbox
impl UnsafeUnpin for Checkbox
impl UnwindSafe for Checkbox
Blanket Implementations§
impl<T> Action for T
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<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
Source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can
then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.Source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be
further downcast into Rc<ConcreteType> where ConcreteType implements Trait.Source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &Any’s vtable from &Trait’s.Source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &mut Any’s vtable from &mut Trait’s.Source§impl<T> DowncastSync for T
impl<T> DowncastSync for T
Source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
Source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
Source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key and return true if they are equal.