Struct kas_core::layout::SolveCache

pub struct SolveCache { /* private fields */ }

Size solver

This struct is used to solve widget layout, read size constraints and cache the results until the next solver run.

SolveCache::find_constraints constructs an instance of this struct, solving for size constraints.

SolveCache::apply_rect accepts a Rect, updates constraints as necessary and sets widget positions within this rect.

Implementations

impl SolveCache

pub fn min(&self, inner_margin: bool) -> Size

Get the minimum size

If inner_margin is true, margins are included in the result.

pub fn ideal(&self, inner_margin: bool) -> Size

Get the ideal size

If inner_margin is true, margins are included in the result.

pub fn margins(&self) -> Margins

Get the margins

pub fn find_constraints(widget: &mut dyn Widget, size_mgr: SizeMgr<'_>) -> Self

Calculate required size of widget

Assumes no explicit alignment.

pub fn invalidate_rule_cache(&mut self)

Force updating of size rules

This should be called whenever widget size rules have been changed. It forces SolveCache::apply_rect to recompute these rules when next called.

pub fn apply_rect(
    &mut self,
    widget: &mut dyn Widget,
    mgr: &mut ConfigMgr<'_>,
    rect: Rect,
    inner_margin: bool,
    print_heirarchy: bool
)

Apply layout solution to a widget

The widget’s layout is solved for the given rect and assigned. If inner_margin is true, margins are internal to this rect; if not, the caller is responsible for handling margins.

If SolveCache::invalidate_rule_cache was called since rules were last calculated then this method will recalculate all rules; otherwise it will only do so if necessary (when dimensions do not match those last used).