Struct Window

pub struct Window<'open> { /* private fields */ }

Builder for a floating window which can be dragged, closed, collapsed, resized and scrolled (off by default).

You can customize:

• title
• default, minimum, maximum and/or fixed size, collapsed/expanded
• if the window has a scroll area (off by default)
• if the window can be collapsed (minimized) to just the title bar (yes, by default)
• if there should be a close button (none by default)

egui::Window::new("My Window").show(ctx, |ui| {
   ui.label("Hello World!");
});

The previous rectangle used by this window can be obtained through crate::Memory::area_rect().

Implementations

impl<'open> Window<'open>

pub fn new(title: impl Into<WidgetText>) -> Window<'open>

The window title is used as a unique Id and must be unique, and should not change. This is true even if you disable the title bar with .title_bar(false). If you need a changing title, you must call window.id(…) with a fixed id.

pub fn id(self, id: Id) -> Window<'open>

Assign a unique id to the Window. Required if the title changes, or is shared with another window.

pub fn open(self, open: &'open mut bool) -> Window<'open>

Call this to add a close-button to the window title bar.

• If *open == false, the window will not be visible.
• If *open == true, the window will have a close button.
• If the close button is pressed, *open will be set to false.

pub fn enabled(self, enabled: bool) -> Window<'open>

If false the window will be grayed out and non-interactive.

pub fn interactable(self, interactable: bool) -> Window<'open>

If false the window will be non-interactive.

pub fn movable(self, movable: bool) -> Window<'open>

If false the window will be immovable.

pub fn mutate(self, mutate: impl Fn(&mut Window<'open>)) -> Window<'open>

Usage: Window::new(…).mutate(|w| w.resize = w.resize.auto_expand_width(true))

pub fn resize(self, mutate: impl Fn(Resize) -> Resize) -> Window<'open>

Usage: Window::new(…).resize(|r| r.auto_expand_width(true))

pub fn frame(self, frame: Frame) -> Window<'open>

Change the background color, margins, etc.

pub fn min_width(self, min_width: f32) -> Window<'open>

Set minimum width of the window.

pub fn min_height(self, min_height: f32) -> Window<'open>

Set minimum height of the window.

pub fn current_pos(self, current_pos: impl Into<Pos2>) -> Window<'open>

Set current position of the window. If the window is movable it is up to you to keep track of where it moved to!

pub fn default_pos(self, default_pos: impl Into<Pos2>) -> Window<'open>

Set initial position of the window.

pub fn fixed_pos(self, pos: impl Into<Pos2>) -> Window<'open>

Sets the window position and prevents it from being dragged around.

pub fn constrain(self, constrain: bool) -> Window<'open>

Constrains this window to the screen bounds.

To change the area to constrain to, use Self::constraint_to.

Default: true.

pub fn constraint_to(self, constrain_rect: Rect) -> Window<'open>

Constraint the movement of the window to the given rectangle.

For instance: .constrain_to(ctx.screen_rect()).

pub fn drag_bounds(self, constrain_rect: Rect) -> Window<'open>

👎Deprecated: Use constrain_to instead

pub fn pivot(self, pivot: Align2) -> Window<'open>

Where the “root” of the window is.

For instance, if you set this to Align2::RIGHT_TOP then Self::fixed_pos will set the position of the right-top corner of the window.

Default: Align2::LEFT_TOP.

pub fn anchor(self, align: Align2, offset: impl Into<Vec2>) -> Window<'open>

Set anchor and distance.

An anchor of Align2::RIGHT_TOP means “put the right-top corner of the window in the right-top corner of the screen”.

The offset is added to the position, so e.g. an offset of [-5.0, 5.0] would move the window left and down from the given anchor.

Anchoring also makes the window immovable.

It is an error to set both an anchor and a position.

pub fn default_open(self, default_open: bool) -> Window<'open>

Set initial collapsed state of the window

pub fn default_size(self, default_size: impl Into<Vec2>) -> Window<'open>

Set initial size of the window.

pub fn default_width(self, default_width: f32) -> Window<'open>

Set initial width of the window.

pub fn default_height(self, default_height: f32) -> Window<'open>

Set initial height of the window.

pub fn fixed_size(self, size: impl Into<Vec2>) -> Window<'open>

Sets the window size and prevents it from being resized by dragging its edges.

pub fn default_rect(self, rect: Rect) -> Window<'open>

Set initial position and size of the window.

pub fn fixed_rect(self, rect: Rect) -> Window<'open>

Sets the window pos and size and prevents it from being moved and resized by dragging its edges.

pub fn resizable(self, resizable: bool) -> Window<'open>

Can the user resize the window by dragging its edges?

Note that even if you set this to false the window may still auto-resize.

Default is true.

pub fn collapsible(self, collapsible: bool) -> Window<'open>

Can the window be collapsed by clicking on its title?

pub fn title_bar(self, title_bar: bool) -> Window<'open>

Show title bar on top of the window? If false, the window will not be collapsible nor have a close-button.

pub fn auto_sized(self) -> Window<'open>

Not resizable, just takes the size of its contents. Also disabled scrolling. Text will not wrap, but will instead make your window width expand.

pub fn scroll2(self, scroll: [bool; 2]) -> Window<'open>

Enable/disable horizontal/vertical scrolling. false by default.

pub fn hscroll(self, hscroll: bool) -> Window<'open>

Enable/disable horizontal scrolling. false by default.

pub fn vscroll(self, vscroll: bool) -> Window<'open>

Enable/disable vertical scrolling. false by default.

pub fn drag_to_scroll(self, drag_to_scroll: bool) -> Window<'open>

Enable/disable scrolling on the window by dragging with the pointer. true by default.

See ScrollArea::drag_to_scroll for more.

impl<'open> Window<'open>

pub fn show<R>( self, ctx: &Context, add_contents: impl FnOnce(&mut Ui) -> R, ) -> Option<InnerResponse<Option<R>>>

Returns None if the window is not open (if Window::open was called with &mut false). Returns Some(InnerResponse { inner: None }) if the window is collapsed.