Struct WindowConfig 

pub struct WindowConfig {
    pub kind: WindowKind,
    pub size: Size,
    pub activates: bool,
    pub anchor: Rect,
}

What a frame says about a window it declares (Core::declare_window). Plain data by ADR 0004 decision 5 — no title, no callbacks — so a WindowCommand stays Copy and equality is derived, which is how the diff tells two declarations of one name apart.

Read on the opening edge only. The config that reaches WindowCommand::Open is the one the declaration carried on the frame it started; a live window’s config is never looked at again, so re-declaring "palette" at a new size does not resize it. The user owns a window’s geometry once it exists.

Fields

kind: WindowKind

size: Size

Initial inner size, logical px.

activates: bool

Whether opening it takes OS focus. True for a normal window; WindowConfig::popup turns it off, so the field that opened a dropdown keeps the ring while the list is up.

anchor: Rect

WindowKind::Popup only: what the popup is placed against, as a rect in the declaring window’s logical viewport coordinates — which is exactly the rect an onLayout node reports, so an app needs no new geometry query to fill it. The driver resolves it to screen coordinates against the owner’s own position and puts the popup below it, flipping above when the display’s bottom edge is nearer than the popup is tall.

Read on the opening edge with the rest of the config and never again: a popup that has to follow a moving anchor stops being declared and is declared again, which is what a dropdown does when its field scrolls away anyway. Ignored by a Normal window.

Implementations

impl WindowConfig

pub const DEFAULT_SIZE: Size

The size a declaration that names none gets.

pub fn to_value(&self) -> Value

{kind, width, height, activates, anchor: {x, y, w, h}}.

pub fn sized(w: f32, h: f32) -> WindowConfig

A normal, activating window of w x h logical px.

pub fn popup(anchor: Rect, w: f32, h: f32) -> WindowConfig

A WindowKind::Popup of w x h logical px placed against anchor — the rect, in the declaring window’s viewport coordinates, that an onLayout handler reported for the field or button the menu belongs to.

Non-activating, which is the default a popup wants and the reason this is a constructor rather than a kind you set: a popup that takes OS focus blurs whatever opened it. Set activates back to true afterwards for the rare surface that should steal focus.

pub fn of_kind(kind: WindowKind) -> WindowConfig

The defaults for a window of kind: the one decision the kind makes on its own is whether opening it takes OS focus — a popup that did would blur the field that opened it, so it does not unless asked. Every binding’s window entry starts from this.

pub fn from_value(v: &Value) -> Result<(String, WindowConfig), String>

A declaration from plain data: a bare name (the defaults), or a map with name, kind ("normal" | "popup"), width and height (both and positive, or the default size), activates, and the anchor rect ({x, y, w, h}) a popup is placed against. Returns the name with the config. An entry is plain data with a fixed shape, not a node’s loose prop bag, so a value that does nothing is refused rather than dropped: a kind kui does not have would otherwise open a normal window and read as the popup having worked.

Trait Implementations

impl Clone for WindowConfig

fn clone(&self) -> WindowConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for WindowConfig

impl Debug for WindowConfig

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

Formats the value using the given formatter.

impl Default for WindowConfig

fn default() -> WindowConfig

Returns the “default value” for a type.

impl PartialEq for WindowConfig

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for WindowConfig