Struct Window 

pub struct Window { /* private fields */ }

A top-level window with a glass look and a tree of widgets.

Make it with a Ui, add widgets, set the root, and show it. The event loop gives Event::Window when it has events. Dropping the window closes it.

Implementations

impl Window

pub fn new(ui: &Ui, title: &str, width: f32, height: f32) -> Result<Self>

A hidden window with this title and a client area of this size, in DIPs. It shows after Window::show.

Examples found in repository

examples/kanban.rs (line 26)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Kanban", 820.0, 520.0)?;
    window.set_min_size(560.0, 360.0);

    let mut board = Board::new(&mut window, &["To do", "Doing", "Done"]);
    for (lane, title, body) in CARDS {
        board.add_card(&mut window, lane, CardData::new(title, body));
    }
    let pinned = CardData {
        pinned: true,
        ..CardData::new("Ask for the budget", "")
    };
    board.add_card(&mut window, 1, pinned);

    let title = window.add(Text::new("Board").style(TextStyle::Title));
    let gap = window.add(Spacer::fill());
    let archived = window.add(Button::new("Show archived"));
    let top = window.add(Row::new().child(title).child(gap).child(archived));
    let root = window.add(
        Column::new()
            .padding(Insets::all(16.0))
            .gap(12.0)
            .child(top)
            .child(board.widget()),
    );
    window.set_root(root);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::CloseRequested => return Ok(()),
                        WindowEvent::Clicked(id) if id == archived => {
                            let show = !board.show_archived();
                            board.set_show_archived(&mut window, show);
                            let label = if show {
                                "Hide archived"
                            } else {
                                "Show archived"
                            };
                            window.set_text(archived, label);
                        }
                        event => {
                            if let Some(change) = board.handle(&ui, &mut window, &event)? {
                                println!("{}", describe(&board, &change));
                            }
                        }
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

examples/sidebar.rs (line 25)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Side bar", 560.0, 360.0)?;
    window.set_min_size(360.0, 260.0);

    let items = PAGES.map(|(name, icon)| window.add(NavItem::new(name).icon(icon)));
    let pages = PAGES.map(|(name, _)| {
        let title = window.add(Text::new(name).style(TextStyle::Title));
        window.add(Column::new().padding(Insets::all(16.0)).child(title))
    });
    let gap = window.add(Spacer::fill());
    let mode = match std::env::args().nth(1).as_deref() {
        Some("icons") => SideMode::Icons,
        Some("collapsed") => SideMode::Collapsed,
        _ => SideMode::Expanded,
    };
    let side = window.add(
        SideBar::new()
            .title("glasskit")
            .expanded_width(180.0)
            .mode(mode)
            .gap(4.0)
            .child(items[0])
            .child(items[1])
            .child(gap)
            .child(items[2]),
    );
    let stack = window.add(Stack::new().width(Length::Fill(1.0)).children(pages));
    let root = window.add(
        Row::new()
            .padding(Insets::all(8.0))
            .gap(8.0)
            .align(Align::Stretch)
            .child(side)
            .child(stack),
    );
    window.set_root(root);
    let show = |window: &mut Window, shown: usize| {
        for (i, (item, page)) in items.into_iter().zip(pages).enumerate() {
            window.set_selected(item, i == shown);
            window.set_visible(page, i == shown);
        }
    };
    show(&mut window, 0);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(id) => {
                            if let Some(shown) = items.iter().position(|&item| id == item) {
                                show(&mut window, shown);
                            }
                        }
                        WindowEvent::SideModeChanged(id) if id == side => {
                            println!("{:?}", window.side_mode(side));
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

examples/window.rs (line 18)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "glasskit", 420.0, 330.0)?;
    window.set_min_size(320.0, 290.0);
    match std::env::args().nth(1).as_deref() {
        Some("glass") => window.set_material(Material::Glass),
        Some("solid") => window.set_material(Material::Solid),
        _ => {}
    }

    let title = window.add(Text::new("Settings").style(TextStyle::Title));
    let note = window.add(Text::new(
        "Widgets lay out in rows and columns, and the window follows the display scale.",
    ));
    let count = window.add(Text::new("Count: 0").style(TextStyle::BodyStrong));
    let add = window.add(Button::new("Add one"));
    let counter = window.add(Row::new().gap(12.0).child(count).child(add));
    let card = window.add(Card::new().child(counter));
    let name = window.add(TextBox::new().placeholder("Your name").max_length(40));
    let spacer = window.add(Spacer::fill());
    let cancel = window.add(Button::new("Cancel"));
    let ok = window.add(Button::new("OK").accent());
    let buttons = window.add(Row::new().gap(8.0).child(spacer).child(cancel).child(ok));
    let gap = window.add(Spacer::fill());
    let root = window.add(
        Column::new()
            .padding(Insets::all(24.0))
            .gap(12.0)
            .child(title)
            .child(note)
            .child(card)
            .child(name)
            .child(gap)
            .child(buttons),
    );
    window.set_root(root);
    window.show();

    let mut n = 0;
    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(b) if b == add => {
                            n += 1;
                            window.set_text(count, &format!("Count: {n}"));
                            println!("count {n}");
                        }
                        WindowEvent::Clicked(b) if b == ok => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Submitted(b) if b == name => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Clicked(b) if b == cancel => return Ok(()),
                        WindowEvent::Key(k) if k.is_plain(Key::ESCAPE) => {
                            println!("escape");
                            return Ok(());
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

pub fn id(&self) -> WindowId

The id that Event::Window gives for this window.

Examples found in repository

examples/kanban.rs (line 55)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Kanban", 820.0, 520.0)?;
    window.set_min_size(560.0, 360.0);

    let mut board = Board::new(&mut window, &["To do", "Doing", "Done"]);
    for (lane, title, body) in CARDS {
        board.add_card(&mut window, lane, CardData::new(title, body));
    }
    let pinned = CardData {
        pinned: true,
        ..CardData::new("Ask for the budget", "")
    };
    board.add_card(&mut window, 1, pinned);

    let title = window.add(Text::new("Board").style(TextStyle::Title));
    let gap = window.add(Spacer::fill());
    let archived = window.add(Button::new("Show archived"));
    let top = window.add(Row::new().child(title).child(gap).child(archived));
    let root = window.add(
        Column::new()
            .padding(Insets::all(16.0))
            .gap(12.0)
            .child(top)
            .child(board.widget()),
    );
    window.set_root(root);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::CloseRequested => return Ok(()),
                        WindowEvent::Clicked(id) if id == archived => {
                            let show = !board.show_archived();
                            board.set_show_archived(&mut window, show);
                            let label = if show {
                                "Hide archived"
                            } else {
                                "Show archived"
                            };
                            window.set_text(archived, label);
                        }
                        event => {
                            if let Some(change) = board.handle(&ui, &mut window, &event)? {
                                println!("{}", describe(&board, &change));
                            }
                        }
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

examples/sidebar.rs (line 71)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Side bar", 560.0, 360.0)?;
    window.set_min_size(360.0, 260.0);

    let items = PAGES.map(|(name, icon)| window.add(NavItem::new(name).icon(icon)));
    let pages = PAGES.map(|(name, _)| {
        let title = window.add(Text::new(name).style(TextStyle::Title));
        window.add(Column::new().padding(Insets::all(16.0)).child(title))
    });
    let gap = window.add(Spacer::fill());
    let mode = match std::env::args().nth(1).as_deref() {
        Some("icons") => SideMode::Icons,
        Some("collapsed") => SideMode::Collapsed,
        _ => SideMode::Expanded,
    };
    let side = window.add(
        SideBar::new()
            .title("glasskit")
            .expanded_width(180.0)
            .mode(mode)
            .gap(4.0)
            .child(items[0])
            .child(items[1])
            .child(gap)
            .child(items[2]),
    );
    let stack = window.add(Stack::new().width(Length::Fill(1.0)).children(pages));
    let root = window.add(
        Row::new()
            .padding(Insets::all(8.0))
            .gap(8.0)
            .align(Align::Stretch)
            .child(side)
            .child(stack),
    );
    window.set_root(root);
    let show = |window: &mut Window, shown: usize| {
        for (i, (item, page)) in items.into_iter().zip(pages).enumerate() {
            window.set_selected(item, i == shown);
            window.set_visible(page, i == shown);
        }
    };
    show(&mut window, 0);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(id) => {
                            if let Some(shown) = items.iter().position(|&item| id == item) {
                                show(&mut window, shown);
                            }
                        }
                        WindowEvent::SideModeChanged(id) if id == side => {
                            println!("{:?}", window.side_mode(side));
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

examples/window.rs (line 57)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "glasskit", 420.0, 330.0)?;
    window.set_min_size(320.0, 290.0);
    match std::env::args().nth(1).as_deref() {
        Some("glass") => window.set_material(Material::Glass),
        Some("solid") => window.set_material(Material::Solid),
        _ => {}
    }

    let title = window.add(Text::new("Settings").style(TextStyle::Title));
    let note = window.add(Text::new(
        "Widgets lay out in rows and columns, and the window follows the display scale.",
    ));
    let count = window.add(Text::new("Count: 0").style(TextStyle::BodyStrong));
    let add = window.add(Button::new("Add one"));
    let counter = window.add(Row::new().gap(12.0).child(count).child(add));
    let card = window.add(Card::new().child(counter));
    let name = window.add(TextBox::new().placeholder("Your name").max_length(40));
    let spacer = window.add(Spacer::fill());
    let cancel = window.add(Button::new("Cancel"));
    let ok = window.add(Button::new("OK").accent());
    let buttons = window.add(Row::new().gap(8.0).child(spacer).child(cancel).child(ok));
    let gap = window.add(Spacer::fill());
    let root = window.add(
        Column::new()
            .padding(Insets::all(24.0))
            .gap(12.0)
            .child(title)
            .child(note)
            .child(card)
            .child(name)
            .child(gap)
            .child(buttons),
    );
    window.set_root(root);
    window.show();

    let mut n = 0;
    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(b) if b == add => {
                            n += 1;
                            window.set_text(count, &format!("Count: {n}"));
                            println!("count {n}");
                        }
                        WindowEvent::Clicked(b) if b == ok => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Submitted(b) if b == name => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Clicked(b) if b == cancel => return Ok(()),
                        WindowEvent::Key(k) if k.is_plain(Key::ESCAPE) => {
                            println!("escape");
                            return Ok(());
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

pub fn show(&self)

Show the window and bring it to the front.

Examples found in repository

examples/kanban.rs (line 51)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Kanban", 820.0, 520.0)?;
    window.set_min_size(560.0, 360.0);

    let mut board = Board::new(&mut window, &["To do", "Doing", "Done"]);
    for (lane, title, body) in CARDS {
        board.add_card(&mut window, lane, CardData::new(title, body));
    }
    let pinned = CardData {
        pinned: true,
        ..CardData::new("Ask for the budget", "")
    };
    board.add_card(&mut window, 1, pinned);

    let title = window.add(Text::new("Board").style(TextStyle::Title));
    let gap = window.add(Spacer::fill());
    let archived = window.add(Button::new("Show archived"));
    let top = window.add(Row::new().child(title).child(gap).child(archived));
    let root = window.add(
        Column::new()
            .padding(Insets::all(16.0))
            .gap(12.0)
            .child(top)
            .child(board.widget()),
    );
    window.set_root(root);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::CloseRequested => return Ok(()),
                        WindowEvent::Clicked(id) if id == archived => {
                            let show = !board.show_archived();
                            board.set_show_archived(&mut window, show);
                            let label = if show {
                                "Hide archived"
                            } else {
                                "Show archived"
                            };
                            window.set_text(archived, label);
                        }
                        event => {
                            if let Some(change) = board.handle(&ui, &mut window, &event)? {
                                println!("{}", describe(&board, &change));
                            }
                        }
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

examples/sidebar.rs (line 67)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Side bar", 560.0, 360.0)?;
    window.set_min_size(360.0, 260.0);

    let items = PAGES.map(|(name, icon)| window.add(NavItem::new(name).icon(icon)));
    let pages = PAGES.map(|(name, _)| {
        let title = window.add(Text::new(name).style(TextStyle::Title));
        window.add(Column::new().padding(Insets::all(16.0)).child(title))
    });
    let gap = window.add(Spacer::fill());
    let mode = match std::env::args().nth(1).as_deref() {
        Some("icons") => SideMode::Icons,
        Some("collapsed") => SideMode::Collapsed,
        _ => SideMode::Expanded,
    };
    let side = window.add(
        SideBar::new()
            .title("glasskit")
            .expanded_width(180.0)
            .mode(mode)
            .gap(4.0)
            .child(items[0])
            .child(items[1])
            .child(gap)
            .child(items[2]),
    );
    let stack = window.add(Stack::new().width(Length::Fill(1.0)).children(pages));
    let root = window.add(
        Row::new()
            .padding(Insets::all(8.0))
            .gap(8.0)
            .align(Align::Stretch)
            .child(side)
            .child(stack),
    );
    window.set_root(root);
    let show = |window: &mut Window, shown: usize| {
        for (i, (item, page)) in items.into_iter().zip(pages).enumerate() {
            window.set_selected(item, i == shown);
            window.set_visible(page, i == shown);
        }
    };
    show(&mut window, 0);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(id) => {
                            if let Some(shown) = items.iter().position(|&item| id == item) {
                                show(&mut window, shown);
                            }
                        }
                        WindowEvent::SideModeChanged(id) if id == side => {
                            println!("{:?}", window.side_mode(side));
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

examples/window.rs (line 52)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "glasskit", 420.0, 330.0)?;
    window.set_min_size(320.0, 290.0);
    match std::env::args().nth(1).as_deref() {
        Some("glass") => window.set_material(Material::Glass),
        Some("solid") => window.set_material(Material::Solid),
        _ => {}
    }

    let title = window.add(Text::new("Settings").style(TextStyle::Title));
    let note = window.add(Text::new(
        "Widgets lay out in rows and columns, and the window follows the display scale.",
    ));
    let count = window.add(Text::new("Count: 0").style(TextStyle::BodyStrong));
    let add = window.add(Button::new("Add one"));
    let counter = window.add(Row::new().gap(12.0).child(count).child(add));
    let card = window.add(Card::new().child(counter));
    let name = window.add(TextBox::new().placeholder("Your name").max_length(40));
    let spacer = window.add(Spacer::fill());
    let cancel = window.add(Button::new("Cancel"));
    let ok = window.add(Button::new("OK").accent());
    let buttons = window.add(Row::new().gap(8.0).child(spacer).child(cancel).child(ok));
    let gap = window.add(Spacer::fill());
    let root = window.add(
        Column::new()
            .padding(Insets::all(24.0))
            .gap(12.0)
            .child(title)
            .child(note)
            .child(card)
            .child(name)
            .child(gap)
            .child(buttons),
    );
    window.set_root(root);
    window.show();

    let mut n = 0;
    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(b) if b == add => {
                            n += 1;
                            window.set_text(count, &format!("Count: {n}"));
                            println!("count {n}");
                        }
                        WindowEvent::Clicked(b) if b == ok => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Submitted(b) if b == name => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Clicked(b) if b == cancel => return Ok(()),
                        WindowEvent::Key(k) if k.is_plain(Key::ESCAPE) => {
                            println!("escape");
                            return Ok(());
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

pub fn add<K>(&mut self, element: impl Into<Element<K>>) -> Id<K>

Add a widget, and give its id. It shows when it is in the tree under the root.

Examples found in repository

examples/kanban.rs (line 39)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Kanban", 820.0, 520.0)?;
    window.set_min_size(560.0, 360.0);

    let mut board = Board::new(&mut window, &["To do", "Doing", "Done"]);
    for (lane, title, body) in CARDS {
        board.add_card(&mut window, lane, CardData::new(title, body));
    }
    let pinned = CardData {
        pinned: true,
        ..CardData::new("Ask for the budget", "")
    };
    board.add_card(&mut window, 1, pinned);

    let title = window.add(Text::new("Board").style(TextStyle::Title));
    let gap = window.add(Spacer::fill());
    let archived = window.add(Button::new("Show archived"));
    let top = window.add(Row::new().child(title).child(gap).child(archived));
    let root = window.add(
        Column::new()
            .padding(Insets::all(16.0))
            .gap(12.0)
            .child(top)
            .child(board.widget()),
    );
    window.set_root(root);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::CloseRequested => return Ok(()),
                        WindowEvent::Clicked(id) if id == archived => {
                            let show = !board.show_archived();
                            board.set_show_archived(&mut window, show);
                            let label = if show {
                                "Hide archived"
                            } else {
                                "Show archived"
                            };
                            window.set_text(archived, label);
                        }
                        event => {
                            if let Some(change) = board.handle(&ui, &mut window, &event)? {
                                println!("{}", describe(&board, &change));
                            }
                        }
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

examples/sidebar.rs (line 28)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Side bar", 560.0, 360.0)?;
    window.set_min_size(360.0, 260.0);

    let items = PAGES.map(|(name, icon)| window.add(NavItem::new(name).icon(icon)));
    let pages = PAGES.map(|(name, _)| {
        let title = window.add(Text::new(name).style(TextStyle::Title));
        window.add(Column::new().padding(Insets::all(16.0)).child(title))
    });
    let gap = window.add(Spacer::fill());
    let mode = match std::env::args().nth(1).as_deref() {
        Some("icons") => SideMode::Icons,
        Some("collapsed") => SideMode::Collapsed,
        _ => SideMode::Expanded,
    };
    let side = window.add(
        SideBar::new()
            .title("glasskit")
            .expanded_width(180.0)
            .mode(mode)
            .gap(4.0)
            .child(items[0])
            .child(items[1])
            .child(gap)
            .child(items[2]),
    );
    let stack = window.add(Stack::new().width(Length::Fill(1.0)).children(pages));
    let root = window.add(
        Row::new()
            .padding(Insets::all(8.0))
            .gap(8.0)
            .align(Align::Stretch)
            .child(side)
            .child(stack),
    );
    window.set_root(root);
    let show = |window: &mut Window, shown: usize| {
        for (i, (item, page)) in items.into_iter().zip(pages).enumerate() {
            window.set_selected(item, i == shown);
            window.set_visible(page, i == shown);
        }
    };
    show(&mut window, 0);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(id) => {
                            if let Some(shown) = items.iter().position(|&item| id == item) {
                                show(&mut window, shown);
                            }
                        }
                        WindowEvent::SideModeChanged(id) if id == side => {
                            println!("{:?}", window.side_mode(side));
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

examples/window.rs (line 26)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "glasskit", 420.0, 330.0)?;
    window.set_min_size(320.0, 290.0);
    match std::env::args().nth(1).as_deref() {
        Some("glass") => window.set_material(Material::Glass),
        Some("solid") => window.set_material(Material::Solid),
        _ => {}
    }

    let title = window.add(Text::new("Settings").style(TextStyle::Title));
    let note = window.add(Text::new(
        "Widgets lay out in rows and columns, and the window follows the display scale.",
    ));
    let count = window.add(Text::new("Count: 0").style(TextStyle::BodyStrong));
    let add = window.add(Button::new("Add one"));
    let counter = window.add(Row::new().gap(12.0).child(count).child(add));
    let card = window.add(Card::new().child(counter));
    let name = window.add(TextBox::new().placeholder("Your name").max_length(40));
    let spacer = window.add(Spacer::fill());
    let cancel = window.add(Button::new("Cancel"));
    let ok = window.add(Button::new("OK").accent());
    let buttons = window.add(Row::new().gap(8.0).child(spacer).child(cancel).child(ok));
    let gap = window.add(Spacer::fill());
    let root = window.add(
        Column::new()
            .padding(Insets::all(24.0))
            .gap(12.0)
            .child(title)
            .child(note)
            .child(card)
            .child(name)
            .child(gap)
            .child(buttons),
    );
    window.set_root(root);
    window.show();

    let mut n = 0;
    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(b) if b == add => {
                            n += 1;
                            window.set_text(count, &format!("Count: {n}"));
                            println!("count {n}");
                        }
                        WindowEvent::Clicked(b) if b == ok => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Submitted(b) if b == name => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Clicked(b) if b == cancel => return Ok(()),
                        WindowEvent::Key(k) if k.is_plain(Key::ESCAPE) => {
                            println!("escape");
                            return Ok(());
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

pub fn set_root(&mut self, root: impl Into<AnyId>)

The widget that fills the window. Its children, and their children, show.

Examples found in repository

examples/kanban.rs (line 50)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Kanban", 820.0, 520.0)?;
    window.set_min_size(560.0, 360.0);

    let mut board = Board::new(&mut window, &["To do", "Doing", "Done"]);
    for (lane, title, body) in CARDS {
        board.add_card(&mut window, lane, CardData::new(title, body));
    }
    let pinned = CardData {
        pinned: true,
        ..CardData::new("Ask for the budget", "")
    };
    board.add_card(&mut window, 1, pinned);

    let title = window.add(Text::new("Board").style(TextStyle::Title));
    let gap = window.add(Spacer::fill());
    let archived = window.add(Button::new("Show archived"));
    let top = window.add(Row::new().child(title).child(gap).child(archived));
    let root = window.add(
        Column::new()
            .padding(Insets::all(16.0))
            .gap(12.0)
            .child(top)
            .child(board.widget()),
    );
    window.set_root(root);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::CloseRequested => return Ok(()),
                        WindowEvent::Clicked(id) if id == archived => {
                            let show = !board.show_archived();
                            board.set_show_archived(&mut window, show);
                            let label = if show {
                                "Hide archived"
                            } else {
                                "Show archived"
                            };
                            window.set_text(archived, label);
                        }
                        event => {
                            if let Some(change) = board.handle(&ui, &mut window, &event)? {
                                println!("{}", describe(&board, &change));
                            }
                        }
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

examples/sidebar.rs (line 59)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Side bar", 560.0, 360.0)?;
    window.set_min_size(360.0, 260.0);

    let items = PAGES.map(|(name, icon)| window.add(NavItem::new(name).icon(icon)));
    let pages = PAGES.map(|(name, _)| {
        let title = window.add(Text::new(name).style(TextStyle::Title));
        window.add(Column::new().padding(Insets::all(16.0)).child(title))
    });
    let gap = window.add(Spacer::fill());
    let mode = match std::env::args().nth(1).as_deref() {
        Some("icons") => SideMode::Icons,
        Some("collapsed") => SideMode::Collapsed,
        _ => SideMode::Expanded,
    };
    let side = window.add(
        SideBar::new()
            .title("glasskit")
            .expanded_width(180.0)
            .mode(mode)
            .gap(4.0)
            .child(items[0])
            .child(items[1])
            .child(gap)
            .child(items[2]),
    );
    let stack = window.add(Stack::new().width(Length::Fill(1.0)).children(pages));
    let root = window.add(
        Row::new()
            .padding(Insets::all(8.0))
            .gap(8.0)
            .align(Align::Stretch)
            .child(side)
            .child(stack),
    );
    window.set_root(root);
    let show = |window: &mut Window, shown: usize| {
        for (i, (item, page)) in items.into_iter().zip(pages).enumerate() {
            window.set_selected(item, i == shown);
            window.set_visible(page, i == shown);
        }
    };
    show(&mut window, 0);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(id) => {
                            if let Some(shown) = items.iter().position(|&item| id == item) {
                                show(&mut window, shown);
                            }
                        }
                        WindowEvent::SideModeChanged(id) if id == side => {
                            println!("{:?}", window.side_mode(side));
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

examples/window.rs (line 51)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "glasskit", 420.0, 330.0)?;
    window.set_min_size(320.0, 290.0);
    match std::env::args().nth(1).as_deref() {
        Some("glass") => window.set_material(Material::Glass),
        Some("solid") => window.set_material(Material::Solid),
        _ => {}
    }

    let title = window.add(Text::new("Settings").style(TextStyle::Title));
    let note = window.add(Text::new(
        "Widgets lay out in rows and columns, and the window follows the display scale.",
    ));
    let count = window.add(Text::new("Count: 0").style(TextStyle::BodyStrong));
    let add = window.add(Button::new("Add one"));
    let counter = window.add(Row::new().gap(12.0).child(count).child(add));
    let card = window.add(Card::new().child(counter));
    let name = window.add(TextBox::new().placeholder("Your name").max_length(40));
    let spacer = window.add(Spacer::fill());
    let cancel = window.add(Button::new("Cancel"));
    let ok = window.add(Button::new("OK").accent());
    let buttons = window.add(Row::new().gap(8.0).child(spacer).child(cancel).child(ok));
    let gap = window.add(Spacer::fill());
    let root = window.add(
        Column::new()
            .padding(Insets::all(24.0))
            .gap(12.0)
            .child(title)
            .child(note)
            .child(card)
            .child(name)
            .child(gap)
            .child(buttons),
    );
    window.set_root(root);
    window.show();

    let mut n = 0;
    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(b) if b == add => {
                            n += 1;
                            window.set_text(count, &format!("Count: {n}"));
                            println!("count {n}");
                        }
                        WindowEvent::Clicked(b) if b == ok => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Submitted(b) if b == name => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Clicked(b) if b == cancel => return Ok(()),
                        WindowEvent::Key(k) if k.is_plain(Key::ESCAPE) => {
                            println!("escape");
                            return Ok(());
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

pub fn text<K: HasText>(&self, id: Id<K>) -> String

The text of a text or a text box, or the label of a button.

Examples found in repository

examples/window.rs (line 66)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "glasskit", 420.0, 330.0)?;
    window.set_min_size(320.0, 290.0);
    match std::env::args().nth(1).as_deref() {
        Some("glass") => window.set_material(Material::Glass),
        Some("solid") => window.set_material(Material::Solid),
        _ => {}
    }

    let title = window.add(Text::new("Settings").style(TextStyle::Title));
    let note = window.add(Text::new(
        "Widgets lay out in rows and columns, and the window follows the display scale.",
    ));
    let count = window.add(Text::new("Count: 0").style(TextStyle::BodyStrong));
    let add = window.add(Button::new("Add one"));
    let counter = window.add(Row::new().gap(12.0).child(count).child(add));
    let card = window.add(Card::new().child(counter));
    let name = window.add(TextBox::new().placeholder("Your name").max_length(40));
    let spacer = window.add(Spacer::fill());
    let cancel = window.add(Button::new("Cancel"));
    let ok = window.add(Button::new("OK").accent());
    let buttons = window.add(Row::new().gap(8.0).child(spacer).child(cancel).child(ok));
    let gap = window.add(Spacer::fill());
    let root = window.add(
        Column::new()
            .padding(Insets::all(24.0))
            .gap(12.0)
            .child(title)
            .child(note)
            .child(card)
            .child(name)
            .child(gap)
            .child(buttons),
    );
    window.set_root(root);
    window.show();

    let mut n = 0;
    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(b) if b == add => {
                            n += 1;
                            window.set_text(count, &format!("Count: {n}"));
                            println!("count {n}");
                        }
                        WindowEvent::Clicked(b) if b == ok => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Submitted(b) if b == name => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Clicked(b) if b == cancel => return Ok(()),
                        WindowEvent::Key(k) if k.is_plain(Key::ESCAPE) => {
                            println!("escape");
                            return Ok(());
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

pub fn set_text<K: HasText>(&mut self, id: Id<K>, value: &str)

Change the text of a text or a text box, or the label of a button. A change here gives no WindowEvent::Changed.

Examples found in repository

examples/kanban.rs (line 67)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Kanban", 820.0, 520.0)?;
    window.set_min_size(560.0, 360.0);

    let mut board = Board::new(&mut window, &["To do", "Doing", "Done"]);
    for (lane, title, body) in CARDS {
        board.add_card(&mut window, lane, CardData::new(title, body));
    }
    let pinned = CardData {
        pinned: true,
        ..CardData::new("Ask for the budget", "")
    };
    board.add_card(&mut window, 1, pinned);

    let title = window.add(Text::new("Board").style(TextStyle::Title));
    let gap = window.add(Spacer::fill());
    let archived = window.add(Button::new("Show archived"));
    let top = window.add(Row::new().child(title).child(gap).child(archived));
    let root = window.add(
        Column::new()
            .padding(Insets::all(16.0))
            .gap(12.0)
            .child(top)
            .child(board.widget()),
    );
    window.set_root(root);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::CloseRequested => return Ok(()),
                        WindowEvent::Clicked(id) if id == archived => {
                            let show = !board.show_archived();
                            board.set_show_archived(&mut window, show);
                            let label = if show {
                                "Hide archived"
                            } else {
                                "Show archived"
                            };
                            window.set_text(archived, label);
                        }
                        event => {
                            if let Some(change) = board.handle(&ui, &mut window, &event)? {
                                println!("{}", describe(&board, &change));
                            }
                        }
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

examples/window.rs (line 62)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "glasskit", 420.0, 330.0)?;
    window.set_min_size(320.0, 290.0);
    match std::env::args().nth(1).as_deref() {
        Some("glass") => window.set_material(Material::Glass),
        Some("solid") => window.set_material(Material::Solid),
        _ => {}
    }

    let title = window.add(Text::new("Settings").style(TextStyle::Title));
    let note = window.add(Text::new(
        "Widgets lay out in rows and columns, and the window follows the display scale.",
    ));
    let count = window.add(Text::new("Count: 0").style(TextStyle::BodyStrong));
    let add = window.add(Button::new("Add one"));
    let counter = window.add(Row::new().gap(12.0).child(count).child(add));
    let card = window.add(Card::new().child(counter));
    let name = window.add(TextBox::new().placeholder("Your name").max_length(40));
    let spacer = window.add(Spacer::fill());
    let cancel = window.add(Button::new("Cancel"));
    let ok = window.add(Button::new("OK").accent());
    let buttons = window.add(Row::new().gap(8.0).child(spacer).child(cancel).child(ok));
    let gap = window.add(Spacer::fill());
    let root = window.add(
        Column::new()
            .padding(Insets::all(24.0))
            .gap(12.0)
            .child(title)
            .child(note)
            .child(card)
            .child(name)
            .child(gap)
            .child(buttons),
    );
    window.set_root(root);
    window.show();

    let mut n = 0;
    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(b) if b == add => {
                            n += 1;
                            window.set_text(count, &format!("Count: {n}"));
                            println!("count {n}");
                        }
                        WindowEvent::Clicked(b) if b == ok => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Submitted(b) if b == name => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Clicked(b) if b == cancel => return Ok(()),
                        WindowEvent::Key(k) if k.is_plain(Key::ESCAPE) => {
                            println!("escape");
                            return Ok(());
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

pub fn set_enabled(&mut self, id: impl Into<AnyId>, enabled: bool)

Turn a widget on or off. A button that is off takes no clicks and no focus.

pub fn set_visible(&mut self, id: impl Into<AnyId>, visible: bool)

Show or hide a widget and all widgets in it. A hidden widget takes no space in its row, column, or stack, and no clicks and no focus. A new widget is visible.

To change pages, put the pages in a Stack, and show one of them.

Examples found in repository

examples/sidebar.rs (line 63)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Side bar", 560.0, 360.0)?;
    window.set_min_size(360.0, 260.0);

    let items = PAGES.map(|(name, icon)| window.add(NavItem::new(name).icon(icon)));
    let pages = PAGES.map(|(name, _)| {
        let title = window.add(Text::new(name).style(TextStyle::Title));
        window.add(Column::new().padding(Insets::all(16.0)).child(title))
    });
    let gap = window.add(Spacer::fill());
    let mode = match std::env::args().nth(1).as_deref() {
        Some("icons") => SideMode::Icons,
        Some("collapsed") => SideMode::Collapsed,
        _ => SideMode::Expanded,
    };
    let side = window.add(
        SideBar::new()
            .title("glasskit")
            .expanded_width(180.0)
            .mode(mode)
            .gap(4.0)
            .child(items[0])
            .child(items[1])
            .child(gap)
            .child(items[2]),
    );
    let stack = window.add(Stack::new().width(Length::Fill(1.0)).children(pages));
    let root = window.add(
        Row::new()
            .padding(Insets::all(8.0))
            .gap(8.0)
            .align(Align::Stretch)
            .child(side)
            .child(stack),
    );
    window.set_root(root);
    let show = |window: &mut Window, shown: usize| {
        for (i, (item, page)) in items.into_iter().zip(pages).enumerate() {
            window.set_selected(item, i == shown);
            window.set_visible(page, i == shown);
        }
    };
    show(&mut window, 0);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(id) => {
                            if let Some(shown) = items.iter().position(|&item| id == item) {
                                show(&mut window, shown);
                            }
                        }
                        WindowEvent::SideModeChanged(id) if id == side => {
                            println!("{:?}", window.side_mode(side));
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

pub fn set_children<I, A>(&mut self, id: impl Into<AnyId>, children: I)

where I: IntoIterator<Item = A>, A: Into<AnyId>,

Give a container these children, in this order, in place of the ones that it has. A widget that was in another container moves out of it. A widget that is in no container does not show, and the app can put it in a container again later.

The texts of a card with a title, and the button and the title of a side bar, stay.

pub fn card_text(&self, id: Id<Card>) -> (String, String)

The title and the body of a card. They are empty for a card without a text.

pub fn set_card_text(&mut self, id: Id<Card>, title: &str, body: &str)

Change the title and the body of a card that was made with a title or a body. A card with an empty body shows only its title.

pub fn set_tint(&mut self, id: Id<Card>, tint: Option<Tint>)

Give a card a color, or take its color away.

pub fn set_pinned(&mut self, id: Id<Card>, pinned: bool)

Show or hide the pin in the corner of a card.

pub fn set_side_mode(&mut self, id: Id<SideBar>, mode: SideMode)

Change how much of a side bar shows. It gives no WindowEvent::SideModeChanged.

pub fn side_mode(&self, id: Id<SideBar>) -> SideMode

How much of a side bar shows.

Examples found in repository

examples/sidebar.rs (line 80)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Side bar", 560.0, 360.0)?;
    window.set_min_size(360.0, 260.0);

    let items = PAGES.map(|(name, icon)| window.add(NavItem::new(name).icon(icon)));
    let pages = PAGES.map(|(name, _)| {
        let title = window.add(Text::new(name).style(TextStyle::Title));
        window.add(Column::new().padding(Insets::all(16.0)).child(title))
    });
    let gap = window.add(Spacer::fill());
    let mode = match std::env::args().nth(1).as_deref() {
        Some("icons") => SideMode::Icons,
        Some("collapsed") => SideMode::Collapsed,
        _ => SideMode::Expanded,
    };
    let side = window.add(
        SideBar::new()
            .title("glasskit")
            .expanded_width(180.0)
            .mode(mode)
            .gap(4.0)
            .child(items[0])
            .child(items[1])
            .child(gap)
            .child(items[2]),
    );
    let stack = window.add(Stack::new().width(Length::Fill(1.0)).children(pages));
    let root = window.add(
        Row::new()
            .padding(Insets::all(8.0))
            .gap(8.0)
            .align(Align::Stretch)
            .child(side)
            .child(stack),
    );
    window.set_root(root);
    let show = |window: &mut Window, shown: usize| {
        for (i, (item, page)) in items.into_iter().zip(pages).enumerate() {
            window.set_selected(item, i == shown);
            window.set_visible(page, i == shown);
        }
    };
    show(&mut window, 0);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(id) => {
                            if let Some(shown) = items.iter().position(|&item| id == item) {
                                show(&mut window, shown);
                            }
                        }
                        WindowEvent::SideModeChanged(id) if id == side => {
                            println!("{:?}", window.side_mode(side));
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

pub fn is_visible(&self, id: impl Into<AnyId>) -> bool

Whether set_visible shows the widget. A visible widget in a hidden container does not show.

pub fn set_selected(&mut self, id: Id<NavItem>, selected: bool)

Mark a navigation item as the one whose page shows, or remove the mark.

Examples found in repository

examples/sidebar.rs (line 62)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Side bar", 560.0, 360.0)?;
    window.set_min_size(360.0, 260.0);

    let items = PAGES.map(|(name, icon)| window.add(NavItem::new(name).icon(icon)));
    let pages = PAGES.map(|(name, _)| {
        let title = window.add(Text::new(name).style(TextStyle::Title));
        window.add(Column::new().padding(Insets::all(16.0)).child(title))
    });
    let gap = window.add(Spacer::fill());
    let mode = match std::env::args().nth(1).as_deref() {
        Some("icons") => SideMode::Icons,
        Some("collapsed") => SideMode::Collapsed,
        _ => SideMode::Expanded,
    };
    let side = window.add(
        SideBar::new()
            .title("glasskit")
            .expanded_width(180.0)
            .mode(mode)
            .gap(4.0)
            .child(items[0])
            .child(items[1])
            .child(gap)
            .child(items[2]),
    );
    let stack = window.add(Stack::new().width(Length::Fill(1.0)).children(pages));
    let root = window.add(
        Row::new()
            .padding(Insets::all(8.0))
            .gap(8.0)
            .align(Align::Stretch)
            .child(side)
            .child(stack),
    );
    window.set_root(root);
    let show = |window: &mut Window, shown: usize| {
        for (i, (item, page)) in items.into_iter().zip(pages).enumerate() {
            window.set_selected(item, i == shown);
            window.set_visible(page, i == shown);
        }
    };
    show(&mut window, 0);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(id) => {
                            if let Some(shown) = items.iter().position(|&item| id == item) {
                                show(&mut window, shown);
                            }
                        }
                        WindowEvent::SideModeChanged(id) if id == side => {
                            println!("{:?}", window.side_mode(side));
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

pub fn is_selected(&self, id: Id<NavItem>) -> bool

Whether a navigation item has the mark.

pub fn focus(&mut self, id: impl Into<AnyId>)

Give the keyboard focus to a widget that can take it.

pub fn set_icon(&self, icon: &Icon) -> Result<()>

Show this picture in the title bar, the taskbar, and Alt+Tab. Windows scales it to each place, so give a large one, such as 64 by 64 pixels.

pub fn set_title(&self, title: &str)

Change the title.

pub fn set_min_size(&self, width: f32, height: f32)

The smallest size of the client area that the user can make, in DIPs.

Examples found in repository

examples/kanban.rs (line 27)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Kanban", 820.0, 520.0)?;
    window.set_min_size(560.0, 360.0);

    let mut board = Board::new(&mut window, &["To do", "Doing", "Done"]);
    for (lane, title, body) in CARDS {
        board.add_card(&mut window, lane, CardData::new(title, body));
    }
    let pinned = CardData {
        pinned: true,
        ..CardData::new("Ask for the budget", "")
    };
    board.add_card(&mut window, 1, pinned);

    let title = window.add(Text::new("Board").style(TextStyle::Title));
    let gap = window.add(Spacer::fill());
    let archived = window.add(Button::new("Show archived"));
    let top = window.add(Row::new().child(title).child(gap).child(archived));
    let root = window.add(
        Column::new()
            .padding(Insets::all(16.0))
            .gap(12.0)
            .child(top)
            .child(board.widget()),
    );
    window.set_root(root);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::CloseRequested => return Ok(()),
                        WindowEvent::Clicked(id) if id == archived => {
                            let show = !board.show_archived();
                            board.set_show_archived(&mut window, show);
                            let label = if show {
                                "Hide archived"
                            } else {
                                "Show archived"
                            };
                            window.set_text(archived, label);
                        }
                        event => {
                            if let Some(change) = board.handle(&ui, &mut window, &event)? {
                                println!("{}", describe(&board, &change));
                            }
                        }
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

examples/sidebar.rs (line 26)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Side bar", 560.0, 360.0)?;
    window.set_min_size(360.0, 260.0);

    let items = PAGES.map(|(name, icon)| window.add(NavItem::new(name).icon(icon)));
    let pages = PAGES.map(|(name, _)| {
        let title = window.add(Text::new(name).style(TextStyle::Title));
        window.add(Column::new().padding(Insets::all(16.0)).child(title))
    });
    let gap = window.add(Spacer::fill());
    let mode = match std::env::args().nth(1).as_deref() {
        Some("icons") => SideMode::Icons,
        Some("collapsed") => SideMode::Collapsed,
        _ => SideMode::Expanded,
    };
    let side = window.add(
        SideBar::new()
            .title("glasskit")
            .expanded_width(180.0)
            .mode(mode)
            .gap(4.0)
            .child(items[0])
            .child(items[1])
            .child(gap)
            .child(items[2]),
    );
    let stack = window.add(Stack::new().width(Length::Fill(1.0)).children(pages));
    let root = window.add(
        Row::new()
            .padding(Insets::all(8.0))
            .gap(8.0)
            .align(Align::Stretch)
            .child(side)
            .child(stack),
    );
    window.set_root(root);
    let show = |window: &mut Window, shown: usize| {
        for (i, (item, page)) in items.into_iter().zip(pages).enumerate() {
            window.set_selected(item, i == shown);
            window.set_visible(page, i == shown);
        }
    };
    show(&mut window, 0);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(id) => {
                            if let Some(shown) = items.iter().position(|&item| id == item) {
                                show(&mut window, shown);
                            }
                        }
                        WindowEvent::SideModeChanged(id) if id == side => {
                            println!("{:?}", window.side_mode(side));
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

examples/window.rs (line 19)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "glasskit", 420.0, 330.0)?;
    window.set_min_size(320.0, 290.0);
    match std::env::args().nth(1).as_deref() {
        Some("glass") => window.set_material(Material::Glass),
        Some("solid") => window.set_material(Material::Solid),
        _ => {}
    }

    let title = window.add(Text::new("Settings").style(TextStyle::Title));
    let note = window.add(Text::new(
        "Widgets lay out in rows and columns, and the window follows the display scale.",
    ));
    let count = window.add(Text::new("Count: 0").style(TextStyle::BodyStrong));
    let add = window.add(Button::new("Add one"));
    let counter = window.add(Row::new().gap(12.0).child(count).child(add));
    let card = window.add(Card::new().child(counter));
    let name = window.add(TextBox::new().placeholder("Your name").max_length(40));
    let spacer = window.add(Spacer::fill());
    let cancel = window.add(Button::new("Cancel"));
    let ok = window.add(Button::new("OK").accent());
    let buttons = window.add(Row::new().gap(8.0).child(spacer).child(cancel).child(ok));
    let gap = window.add(Spacer::fill());
    let root = window.add(
        Column::new()
            .padding(Insets::all(24.0))
            .gap(12.0)
            .child(title)
            .child(note)
            .child(card)
            .child(name)
            .child(gap)
            .child(buttons),
    );
    window.set_root(root);
    window.show();

    let mut n = 0;
    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(b) if b == add => {
                            n += 1;
                            window.set_text(count, &format!("Count: {n}"));
                            println!("count {n}");
                        }
                        WindowEvent::Clicked(b) if b == ok => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Submitted(b) if b == name => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Clicked(b) if b == cancel => return Ok(()),
                        WindowEvent::Key(k) if k.is_plain(Key::ESCAPE) => {
                            println!("escape");
                            return Ok(());
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

pub fn size(&self) -> (f32, f32)

The size of the client area, in DIPs.

pub fn set_material(&self, material: Material)

Change the background. If transparency effects are off, or high contrast is on, the window shows a solid color until they change.

Examples found in repository

examples/window.rs (line 21)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "glasskit", 420.0, 330.0)?;
    window.set_min_size(320.0, 290.0);
    match std::env::args().nth(1).as_deref() {
        Some("glass") => window.set_material(Material::Glass),
        Some("solid") => window.set_material(Material::Solid),
        _ => {}
    }

    let title = window.add(Text::new("Settings").style(TextStyle::Title));
    let note = window.add(Text::new(
        "Widgets lay out in rows and columns, and the window follows the display scale.",
    ));
    let count = window.add(Text::new("Count: 0").style(TextStyle::BodyStrong));
    let add = window.add(Button::new("Add one"));
    let counter = window.add(Row::new().gap(12.0).child(count).child(add));
    let card = window.add(Card::new().child(counter));
    let name = window.add(TextBox::new().placeholder("Your name").max_length(40));
    let spacer = window.add(Spacer::fill());
    let cancel = window.add(Button::new("Cancel"));
    let ok = window.add(Button::new("OK").accent());
    let buttons = window.add(Row::new().gap(8.0).child(spacer).child(cancel).child(ok));
    let gap = window.add(Spacer::fill());
    let root = window.add(
        Column::new()
            .padding(Insets::all(24.0))
            .gap(12.0)
            .child(title)
            .child(note)
            .child(card)
            .child(name)
            .child(gap)
            .child(buttons),
    );
    window.set_root(root);
    window.show();

    let mut n = 0;
    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(b) if b == add => {
                            n += 1;
                            window.set_text(count, &format!("Count: {n}"));
                            println!("count {n}");
                        }
                        WindowEvent::Clicked(b) if b == ok => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Submitted(b) if b == name => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Clicked(b) if b == cancel => return Ok(()),
                        WindowEvent::Key(k) if k.is_plain(Key::ESCAPE) => {
                            println!("escape");
                            return Ok(());
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

pub fn material(&self) -> Material

The background that the app asked for.

pub fn next_event(&mut self) -> Option<WindowEvent>

The next thing that the user did, or None when there is nothing more now.

Examples found in repository

examples/kanban.rs (line 56)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Kanban", 820.0, 520.0)?;
    window.set_min_size(560.0, 360.0);

    let mut board = Board::new(&mut window, &["To do", "Doing", "Done"]);
    for (lane, title, body) in CARDS {
        board.add_card(&mut window, lane, CardData::new(title, body));
    }
    let pinned = CardData {
        pinned: true,
        ..CardData::new("Ask for the budget", "")
    };
    board.add_card(&mut window, 1, pinned);

    let title = window.add(Text::new("Board").style(TextStyle::Title));
    let gap = window.add(Spacer::fill());
    let archived = window.add(Button::new("Show archived"));
    let top = window.add(Row::new().child(title).child(gap).child(archived));
    let root = window.add(
        Column::new()
            .padding(Insets::all(16.0))
            .gap(12.0)
            .child(top)
            .child(board.widget()),
    );
    window.set_root(root);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::CloseRequested => return Ok(()),
                        WindowEvent::Clicked(id) if id == archived => {
                            let show = !board.show_archived();
                            board.set_show_archived(&mut window, show);
                            let label = if show {
                                "Hide archived"
                            } else {
                                "Show archived"
                            };
                            window.set_text(archived, label);
                        }
                        event => {
                            if let Some(change) = board.handle(&ui, &mut window, &event)? {
                                println!("{}", describe(&board, &change));
                            }
                        }
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

examples/sidebar.rs (line 72)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "Side bar", 560.0, 360.0)?;
    window.set_min_size(360.0, 260.0);

    let items = PAGES.map(|(name, icon)| window.add(NavItem::new(name).icon(icon)));
    let pages = PAGES.map(|(name, _)| {
        let title = window.add(Text::new(name).style(TextStyle::Title));
        window.add(Column::new().padding(Insets::all(16.0)).child(title))
    });
    let gap = window.add(Spacer::fill());
    let mode = match std::env::args().nth(1).as_deref() {
        Some("icons") => SideMode::Icons,
        Some("collapsed") => SideMode::Collapsed,
        _ => SideMode::Expanded,
    };
    let side = window.add(
        SideBar::new()
            .title("glasskit")
            .expanded_width(180.0)
            .mode(mode)
            .gap(4.0)
            .child(items[0])
            .child(items[1])
            .child(gap)
            .child(items[2]),
    );
    let stack = window.add(Stack::new().width(Length::Fill(1.0)).children(pages));
    let root = window.add(
        Row::new()
            .padding(Insets::all(8.0))
            .gap(8.0)
            .align(Align::Stretch)
            .child(side)
            .child(stack),
    );
    window.set_root(root);
    let show = |window: &mut Window, shown: usize| {
        for (i, (item, page)) in items.into_iter().zip(pages).enumerate() {
            window.set_selected(item, i == shown);
            window.set_visible(page, i == shown);
        }
    };
    show(&mut window, 0);
    window.show();

    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(id) => {
                            if let Some(shown) = items.iter().position(|&item| id == item) {
                                show(&mut window, shown);
                            }
                        }
                        WindowEvent::SideModeChanged(id) if id == side => {
                            println!("{:?}", window.side_mode(side));
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

examples/window.rs (line 58)

fn main() -> glasskit::Result<()> {
    let ui = Ui::new()?;
    let mut events: EventLoop<()> = EventLoop::new(&ui)?;
    let mut window = Window::new(&ui, "glasskit", 420.0, 330.0)?;
    window.set_min_size(320.0, 290.0);
    match std::env::args().nth(1).as_deref() {
        Some("glass") => window.set_material(Material::Glass),
        Some("solid") => window.set_material(Material::Solid),
        _ => {}
    }

    let title = window.add(Text::new("Settings").style(TextStyle::Title));
    let note = window.add(Text::new(
        "Widgets lay out in rows and columns, and the window follows the display scale.",
    ));
    let count = window.add(Text::new("Count: 0").style(TextStyle::BodyStrong));
    let add = window.add(Button::new("Add one"));
    let counter = window.add(Row::new().gap(12.0).child(count).child(add));
    let card = window.add(Card::new().child(counter));
    let name = window.add(TextBox::new().placeholder("Your name").max_length(40));
    let spacer = window.add(Spacer::fill());
    let cancel = window.add(Button::new("Cancel"));
    let ok = window.add(Button::new("OK").accent());
    let buttons = window.add(Row::new().gap(8.0).child(spacer).child(cancel).child(ok));
    let gap = window.add(Spacer::fill());
    let root = window.add(
        Column::new()
            .padding(Insets::all(24.0))
            .gap(12.0)
            .child(title)
            .child(note)
            .child(card)
            .child(name)
            .child(gap)
            .child(buttons),
    );
    window.set_root(root);
    window.show();

    let mut n = 0;
    loop {
        match events.next(None)? {
            Event::Window(id) if id == window.id() => {
                while let Some(event) = window.next_event() {
                    match event {
                        WindowEvent::Clicked(b) if b == add => {
                            n += 1;
                            window.set_text(count, &format!("Count: {n}"));
                            println!("count {n}");
                        }
                        WindowEvent::Clicked(b) if b == ok => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Submitted(b) if b == name => {
                            println!("ok {}", window.text(name));
                            return Ok(());
                        }
                        WindowEvent::Clicked(b) if b == cancel => return Ok(()),
                        WindowEvent::Key(k) if k.is_plain(Key::ESCAPE) => {
                            println!("escape");
                            return Ok(());
                        }
                        WindowEvent::CloseRequested => return Ok(()),
                        _ => {}
                    }
                }
            }
            Event::Quit => return Ok(()),
            _ => {}
        }
    }
}

Trait Implementations

impl Debug for Window

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

Formats the value using the given formatter.