ui::WindowOptions¶

Header: winui/ui/WindowOptions.hpp.

What a Window is created with: title, size, theme, frame, placement and the per-window services. A Window owns one, given to its constructor. title, theme, backdrop and icon take a value or a property: bound to a property, the window follows it for as long as both live, so one ui::Property<ui::ThemeRequest> can drive every window of an app. style, chrome, system_menu and the size limits seed the Window's own live properties (set_style(), ...), which is where to change them afterwards; the rest is read once, when the OS window is created by ui::run() or Window::show().

A bound field subscribes to its properties while the Window is constructed. A Window that is a class member therefore has to be declared after the properties it binds, since members are constructed in declaration order; bound to a member declared later, it reads an object that does not exist yet.

Example:

int main()
{
    ui::Property<ui::ThemeRequest> theme{{.mode = ui::ThemeMode::Dark}};
    ui::Window window{{
        .title    = "My Application",
        .size     = {1024, 768},
        .theme    = theme, // every window bound to `theme` switches with it
        .backdrop = ui::Backdrop::Mica,
        .min_size = {480, 320},
    }};
    window.set_content(ui::Text{.text = "Hello"});
    return ui::run(window);
}