pub struct BoxConstraints { /* private fields */ }Expand description
Immutable min/max size bounds passed down during layout.
Invariant: both min and max are non-negative and min <= max
component-wise. This is enforced unconditionally by every constructor —
there is no way to construct a BoxConstraints that violates it, so
constrain can never panic.
Implementations§
Source§impl BoxConstraints
impl BoxConstraints
Sourcepub fn new(min: Size, max: Size) -> BoxConstraints
pub fn new(min: Size, max: Size) -> BoxConstraints
Construct constraints from explicit min/max bounds.
Both bounds are clamped to be non-negative. If max is smaller than
min on either axis (an inverted/inconsistent input), max is
widened up to min on that axis — min is authoritative — so the
resulting constraints always satisfy min <= max. Inverted input
usually indicates an upstream layout bug (e.g. padding subtraction
underflow), so debug builds print a diagnostic when this correction
fires; release builds correct silently.
Sourcepub fn tight(size: Size) -> BoxConstraints
pub fn tight(size: Size) -> BoxConstraints
Tight constraints that force an exact size (min == max == size).
Sourcepub fn loose(max: Size) -> BoxConstraints
pub fn loose(max: Size) -> BoxConstraints
Loose constraints allowing anything from zero up to max.
Sourcepub fn constrain(&self, size: Size) -> Size
pub fn constrain(&self, size: Size) -> Size
Clamp size so it lies within [min, max] on both axes.
Sourcepub fn loosen(&self) -> BoxConstraints
pub fn loosen(&self) -> BoxConstraints
Relax the minimum to zero, keeping the same maximum.
Sourcepub fn tighten(&self, size: Size) -> BoxConstraints
pub fn tighten(&self, size: Size) -> BoxConstraints
Return tight constraints at the size clamped into this range.
Useful when a parent wants to force a child to a specific size that still respects the incoming bounds.
Trait Implementations§
Source§impl Clone for BoxConstraints
impl Clone for BoxConstraints
Source§fn clone(&self) -> BoxConstraints
fn clone(&self) -> BoxConstraints
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moreimpl Copy for BoxConstraints
Source§impl Debug for BoxConstraints
impl Debug for BoxConstraints
Source§impl PartialEq for BoxConstraints
impl PartialEq for BoxConstraints
impl StructuralPartialEq for BoxConstraints
Auto Trait Implementations§
impl Freeze for BoxConstraints
impl RefUnwindSafe for BoxConstraints
impl Send for BoxConstraints
impl Sync for BoxConstraints
impl Unpin for BoxConstraints
impl UnsafeUnpin for BoxConstraints
impl UnwindSafe for BoxConstraints
Blanket Implementations§
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.