Struct PopupConfig 

pub struct PopupConfig {
    pub width: u32,
    pub height: Option<u32>,
    pub anchor_rect: Rect,
    pub anchor: PopupAnchor,
    pub gravity: PopupGravity,
    pub offset: (i32, i32),
    pub grab: bool,
    pub background_color: Color,
}

Configuration for an xdg popup anchored to a parent surface.

The compositor positions the popup relative to anchor_rect (parent surface coordinates) and adjusts it to stay on screen (flip/slide).

spawn_popup(
    bar_surface_id,
    PopupConfig::new(250)
        .anchor_rect(button_rect)
        .anchor(PopupAnchor::Bottom)
        .gravity(PopupGravity::Bottom)
        .grab(),
    move || menu_widget(),
);

Fields

width: u32

Popup width in logical pixels.

height: Option<u32>

Popup height in logical pixels. None (the default) sizes the popup to its content: the widget is laid out at the given width before the popup is created, and repositioned when its content height changes (submenus expanding, lists growing). Content using height(fill()) resolves to the screen-height cap — give such popups an explicit height instead.

anchor_rect: Rect

Rectangle the popup anchors to, in parent surface coordinates.

anchor: PopupAnchor

Which point of the anchor rect to attach to.

gravity: PopupGravity

Which direction the popup grows.

offset: (i32, i32)

Extra offset from the anchor point.

grab: bool

Take an input grab: clicking outside dismisses the popup (menu semantics). The compositor reports the dismissal reactively — see PopupHandle::dismissed.

background_color: Color

Background color of the popup surface.

Implementations

impl PopupConfig

pub fn new(width: u32) -> Self

Create a popup configuration with the given width; the height sizes to the content (see PopupConfig::height to fix it instead).

pub fn height(self, height: u32) -> Self

Fix the popup height instead of sizing it to the content.

pub fn anchor_rect(self, rect: Rect) -> Self

Set the rectangle the popup anchors to (parent surface coordinates). Typically a widget’s bounds from a crate::widget_ref::WidgetRef.

pub fn anchor(self, anchor: PopupAnchor) -> Self

Set which point of the anchor rect the popup attaches to.

pub fn gravity(self, gravity: PopupGravity) -> Self

Set which direction the popup grows.

pub fn offset(self, x: i32, y: i32) -> Self

Set an extra offset from the anchor point.

pub fn grab(self) -> Self

Take an input grab: clicking outside dismisses the popup.

pub fn background_color(self, color: Color) -> Self

Set the background color of the popup surface.

Trait Implementations

impl Clone for PopupConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.