Skip to main content

WindowInsets

Struct WindowInsets 

Source
pub struct WindowInsets {
    pub view_padding: EdgeInsets,
    pub view_insets: EdgeInsets,
    pub corner_insets: CornerInsets,
}
Expand description

The window’s inset state, mirroring Flutter’s ViewportMetrics (media_query.dart).

Carries the two per-edge sets a shell transports; the third (the derived safe-area padding) is computed on demand, never stored:

  • view_padding — system-UI-occluded edges (status/navigation bars, display cutout). Never includes the IME.
  • view_insets — fully-obscured area, in practice the on-screen keyboard (IME). The status bar is never part of this on either platform.

All values are logical px (see the module docs). Default is the all-zero state (no occlusion). PartialEq lets a shell compare the freshly-read platform insets against the last-pushed value and skip a no-op set_insets.

Fields§

§view_padding: EdgeInsets

System-UI-occluded edges (status/navigation bars, cutout), in logical px.

§view_insets: EdgeInsets

Fully-obscured edges (the IME/keyboard), in logical px.

§corner_insets: CornerInsets

Window-control corners, in logical px; see CornerInsets.

Implementations§

Source§

impl WindowInsets

Source

pub fn new(view_padding: EdgeInsets, view_insets: EdgeInsets) -> Self

Construct from the two transported per-edge sets; corners are CornerInsets::ZERO (see with_corner_insets).

Source

pub fn with_corner_insets(self, corner_insets: CornerInsets) -> Self

These insets with the window-control corner_insets set. padding() is unaffected.

Source

pub fn padding(&self) -> EdgeInsets

The derived safe-area padding: max(0.0, view_padding - view_insets) per edge (Flutter’s formula, media_query.dart:152-170).

This is what a SafeArea widget insets by — where the IME (view_insets) overlaps a system-bar edge (view_padding), that edge’s safe-area padding clamps to zero (the IME already handles keyboard avoidance for that edge). Computed on demand; never transported.

Source

pub fn consuming( self, left: bool, top: bool, right: bool, bottom: bool, ) -> WindowInsets

These insets with the safe-area padding on each enabled edge marked as consumed — the value a widget that has already padded by those edges hands to its subtree.

Flutter parity: MediaQuery.removePadding as applied by SafeArea. For each enabled edge, view_padding.<edge> is reduced by self.padding().<edge> (saturating at zero); view_insets is left untouched. The invariants are:

  • consuming(..).padding().<edge> == 0.0 on every enabled edge;
  • view_insets is unchanged, so the IME still reaches descendants for keyboard avoidance;
  • disabled edges are unchanged in both sets;
  • consuming(..).corner_insets == self.corner_insets — corners are never consumed;
  • the operation is idempotent — consuming an already-consumed edge is a no-op, which is what makes nested SafeAreas consume only once.

Trait Implementations§

Source§

impl Clone for WindowInsets

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for WindowInsets

Source§

impl Debug for WindowInsets

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for WindowInsets

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl PartialEq for WindowInsets

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for WindowInsets

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> StorageAccess<T> for T

Source§

fn as_borrowed(&self) -> &T

Borrows the value.
Source§

fn into_taken(self) -> T

Takes the value.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.