Struct PxConstraints 

pub struct PxConstraints { /* private fields */ }

Pixel length constraints.

These constraints can express lower and upper bounds, unbounded upper and preference of fill length.

See also the PxConstraints2d.

Implementations

impl PxConstraints

pub fn new_unbounded() -> Self

New unbounded constrain.

pub fn new_bounded(max: Px) -> Self

New bounded between zero and max with no fill.

pub fn new_exact(length: Px) -> Self

New bounded to only allow the length and fill.

pub fn new_fill(length: Px) -> Self

New bounded to fill the length.

pub fn new_range(min: Px, max: Px) -> Self

New bounded to a inclusive range.

Panics

Panics if min is not <= max.

pub fn with_new_min(self, min: Px) -> Self

Returns a copy of the current constraints that has min as the lower bound and max adjusted to be >= min.

pub fn with_min(self, min: Px) -> Self

Returns a copy with_new_min if min is greater then the current minimum.

pub fn with_new_max(self, max: Px) -> Self

Returns a copy of the current constraints that has max as the upper bound and min adjusted to be <= max.

pub fn with_max(self, max: Px) -> Self

Returns a copy with_new_max if max is less then the current maximum or the current maximum is unbounded.

pub fn with_new_exact(self, len: Px) -> Self

Returns a copy of the current constraints that has max and min set to len and fill enabled.

pub fn with_exact(self, len: Px) -> Self

Returns a copy with_new_exact if the new length clamped by the current constraints.

pub fn with_fill(self, fill: bool) -> Self

Returns a copy of the current constraints that sets the is_fill preference.

pub fn with_inner(self, inner: bool) -> Self

Returns a copy of the current constraints that sets the is_inner preference.

pub fn with_fill_and(self, fill: bool) -> Self

Returns a copy of the current constraints that sets the fill preference to “current & fill”.

pub fn with_unbounded(self) -> Self

Returns a copy of the current constraints without upper bound.

pub fn with_less(self, sub: Px) -> Self

Returns a copy of the current constraints with sub subtracted from the min and max bounds.

The subtraction is saturating, does not subtract max if unbounded.

pub fn with_more(self, add: Px) -> Self

Returns a copy of the current constraints with add added to the maximum bounds.

Does a saturation addition, this can potentially unbound the constraints if Px::MAX is reached.

pub fn is_bounded(self) -> bool

Gets if the constraints have an upper bound.

pub fn is_unbounded(self) -> bool

Gets if the constraints have no upper bound.

pub fn is_exact(self) -> bool

Gets if the constraints only allow one length.

pub fn is_fill(self) -> bool

Gets if the context prefers the maximum length over the minimum.

Note that if the constraints are unbounded there is not maximum length, in this case the fill length is the minimum.

pub fn is_fill_max(self) -> bool

Gets if the context prefers the maximum length and there is a maximum length.

pub fn is_inner(self) -> bool

Gets if the context wants the best inner bounds layout the target can provide, without fill padding or overflow clamping.

Widgets have an inner and outer bounds, during normal measure/layout the widget outer is suppose to always fulfill the constraints, and the inner is the actual best approximation to the given constraints. This flag indicates that the panel the child widget to skip this final pad/clamp and just return its best size for the given constraints.

pub fn exact(self) -> Option<Px>

Gets the fixed length if the constraints only allow one length.

pub fn max(self) -> Option<Px>

Gets the maximum allowed length, or None if is unbounded.

The maximum is inclusive.

pub fn min(self) -> Px

Gets the minimum allowed length. The minimum is inclusive.

pub fn max_bounded(self) -> Px

Gets the maximum length if it is bounded, or the minimum if not.

pub fn clamp(self, px: Px) -> Px

Clamp the px by min and max.

pub fn fill(self) -> Px

Gets the fill length, if is_fill this is the maximum length, otherwise it is the minimum length.

pub fn fill_or(self, length: Px) -> Px

Gets the maximum if fill is preferred and max is bounded, or length clamped by the constraints.

pub fn fill_or_exact(self) -> Option<Px>

Gets the max size if is fill and has max bounds, or gets the exact size if min equals max.

pub fn max_or(self, length: Px) -> Px

Gets the maximum length if bounded or length clamped by the constraints.

pub fn inner(self) -> Self

Gets unbounded if is_inner or self if is not inner.

Widgets that clamp/pad a child desired size to fulfill constraints must avoid doing this in is_inner contexts. This helper simply returns unbounded constraints if is inner so that the last clamp/pad step becomes a no-op.

Trait Implementations

impl Clone for PxConstraints

fn clone(&self) -> PxConstraints

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PxConstraints

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PxConstraints

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PxConstraints

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Px> for PxConstraints

fn from(length: Px) -> Self

New exact.

impl Hash for PxConstraints

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl IntoVar<PxConstraints> for Px

fn into_var(self) -> Var<PxConstraints>

New exact.

impl PartialEq for PxConstraints

fn eq(&self, other: &PxConstraints) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for PxConstraints

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Transitionable for PxConstraints

fn lerp(self, to: &Self, step: EasingStep) -> Self

Sample the linear interpolation from self -> to by step.

impl Copy for PxConstraints

impl Eq for PxConstraints

impl IntoValue<PxConstraints> for Px

impl StructuralPartialEq for PxConstraints