Struct WindowOptions 

pub struct WindowOptions {

    pub title: String,
    pub size: Size,
    pub min_size: Option<Size>,
    pub start_hidden: bool,
    pub size_to_fit: bool,
    pub app_name: Option<String>,
    pub locales: Option<AppLocales>,
    pub title_fn: Option<fn() -> String>,
    pub version: Option<String>,
    pub tabbing: WindowTabbing,
    pub chrome: WindowChrome,
    pub background: WindowBackground,
    pub shadow: bool,
    pub resizable: bool,
    pub placement: WindowPlacement,
    pub max_size: Option<Size>,
    pub remember_frame: Option<String>,
    pub key: Option<String>,
    pub kind: WindowKind,
}

Fields

title: String

size: Size

min_size: Option<Size>

start_hidden: bool

Create and mount the window without showing it or activating the app. Supported on AppKit; other backends currently ignore this option. Defaults to false.

Menu-bar apps can keep their initial host hidden and open Preferences on demand. The window still exists and can be shown with WindowHandle::set_visible(true); this does not change the app’s keep-running policy.

size_to_fit: bool

Ask the backend to size this window to its content once it has been built and laid out, rather than keeping Self::size (docs/windows.md). size still decides the width and acts as the height ceiling, so a panel with more content than fits the screen scrolls instead of growing past it.

What a preferences panel wants on every desktop. Ignored by backends that cannot resize a live window, and by the ones with no windows at all.

app_name: Option<String>

The app’s display name for the standard application menu / About (macOS). None falls back to title; set it when title carries extra decoration you don’t want in About <name> (e.g. the showcase’s window title is “Day Showcase (AppKit)” but its app name is “Showcase”).

locales: Option<AppLocales>

The app’s locale catalog, installed by day::launch (docs/localization.md).

The order is why this is the framework’s job: the OS’s languages reach day-l10n from the live backend, and the catalog has to be registered after that hint and before the first localized string is read. An app that installs it itself (before launch, where there is no backend yet) registers against an empty hint list and resolves to DEFAULT, so a French device opens an English window.

title_fn: Option<fn() -> String>

The title, computed once the catalog above is installed: how a window title comes from the catalog rather than a literal. Takes precedence over Self::title, which stays the fallback for the moment before (and for apps with nothing to translate).

A plain fn rather than a closure: this struct is Clone, and the callers are a non-capturing || res::str::app_title().format(), which coerces.

version: Option<String>

The app’s version, for Day’s exit line (Clean exit for <app> v<version> …, docs/lifecycle.md): env!("CARGO_PKG_VERSION") in the app crate, which the scaffold’s window() sets. None falls back to the DAY_APP_VERSION the day CLI sets on a launch.

tabbing: WindowTabbing

macOS window tabbing for this window (Cap::WindowTabbing); ignored elsewhere.

chrome: WindowChrome

The window’s frame: standard, a title bar the content runs under, or none (docs/window-chrome.md). Desktop only; phones and the web ignore it.

background: WindowBackground

What shows behind the content: the window background, nothing, or a system material.

shadow: bool

Whether the window casts the platform’s drop shadow. A transparent, shaped window often wants none.

resizable: bool

Whether the user can resize the window by its edges.

placement: WindowPlacement

Where the window opens.

max_size: Option<Size>

The largest content size the user can resize the window to (Cap::WindowGeometry).

remember_frame: Option<String>

Remember this window’s size, position and maximized state under this key, and reopen it that way next launch (docs/windows.md “Remembered frames”). A position that no attached display shows any more is dropped, so a window never reopens off-screen.

key: Option<String>

The logical window this opens (docs/windows.md): open_window focuses an already-open window with the same key instead of opening a second (the preferences pattern). None always opens a new one.

kind: WindowKind

The kind of window: a regular one, a preferences panel, an About panel.

Implementations

impl WindowOptions

pub fn title(self, title: impl Into<String>) -> Self

The window title. Replaces a title_fn set earlier (the generated res::window_options() sets one), so the last title named wins.

pub fn size(self, width: f64, height: f64) -> Self

The content size the window opens at (desktop; phones fill the screen).

pub fn min_size(self, width: f64, height: f64) -> Self

The smallest content size the user can resize to.

pub fn max_size(self, width: f64, height: f64) -> Self

The largest content size the user can resize to (Cap::WindowGeometry).

pub fn start_hidden(self) -> Self

Create and mount the window without showing it; see Self::start_hidden.

pub fn size_to_fit(self) -> Self

Size the window to its content once built; see Self::size_to_fit.

pub fn app_name(self, name: impl Into<String>) -> Self

The app’s display name for the application menu and About; see Self::app_name.

pub fn locales( self, default: &'static str, catalog: &'static [(&'static str, &'static str)], ) -> Self

The app’s locale catalog, as res::locales::{DEFAULT, CATALOG}; see Self::locales.

pub fn title_fn(self, f: fn() -> String) -> Self

The title, computed once the catalog is installed; see Self::title_fn.

pub fn version(self, version: impl Into<String>) -> Self

The app’s version, for Day’s exit line; see Self::version.

pub fn tabbing(self, tabbing: WindowTabbing) -> Self

macOS window tabbing for this window; see Self::tabbing.

pub fn chrome(self, chrome: WindowChrome) -> Self

The window’s frame; see Self::chrome.

pub fn background(self, background: WindowBackground) -> Self

What shows behind the content; see Self::background.

pub fn no_shadow(self) -> Self

No drop shadow, for a transparent or shaped window; see Self::shadow.

pub fn fixed_size(self) -> Self

A window the user cannot resize; see Self::resizable.

pub fn placement(self, placement: WindowPlacement) -> Self

Where the window opens; see Self::placement.

pub fn remember_frame(self, key: impl Into<String>) -> Self

Remember and restore this window’s frame under key; see Self::remember_frame.

pub fn key(self, key: impl Into<String>) -> Self

The logical window this opens; see Self::key.

pub fn kind(self, kind: WindowKind) -> Self

The kind of window; see Self::kind.

Trait Implementations

impl Clone for WindowOptions

fn clone(&self) -> WindowOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WindowOptions

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

Formats the value using the given formatter.

impl Default for WindowOptions

fn default() -> Self

Returns the “default value” for a type.