Struct PopupOptions 

pub struct PopupOptions {
    pub parent: AnyWindowHandle,
    pub anchor_rect: Bounds<Pixels>,
    pub anchor: PopupAnchor,
    pub gravity: PopupGravity,
    pub constraint_adjustment: PopupConstraintAdjustment,
    pub offset: Point<Pixels>,
    pub grab: bool,
}

Options for a parent-anchored popup window such as a menu, dropdown, context menu or tooltip.

A popup is placed relative to an anchor rectangle on its parent window rather than at an absolute screen position. The platform resolves the final position, so this works both on systems where the compositor owns window placement (Wayland) and on platforms with absolute coordinates.

The popup’s size comes from WindowOptions::window_bounds, whose origin is ignored. All coordinates are in logical pixels.

Fields

parent: AnyWindowHandle

The window the popup is anchored to.

anchor_rect: Bounds<Pixels>

The rectangle the popup is positioned relative to, in the parent window’s coordinate space (the same space element bounds are in). For example, a dropdown menu uses the bounds of the button that opened it.

anchor: PopupAnchor

Which point of Self::anchor_rect the popup is anchored to.

gravity: PopupGravity

The direction in which the popup extends away from the anchor point. A dropdown that drops below its button anchors to PopupAnchor::BottomLeft with a gravity of PopupGravity::BottomRight so it grows down and to the right.

constraint_adjustment: PopupConstraintAdjustment

How the platform may adjust the popup if the requested placement would put it off-screen.

offset: Point<Pixels>

An additional offset applied to the popup after anchoring.

grab: bool

Whether the popup should take an explicit input grab.

Grabbing popups behave like menus: they take keyboard focus and are dismissed when the user clicks outside of them or presses a dismissing key. Use it for menus and comboboxes, not for tooltips or other passive popups.

A grab must be requested while the triggering input is still active, in practice the press of the mouse button that opens the popup. Open grabbing popups from a mouse-down handler rather than a click handler, otherwise the grab is refused.

Automatic dismissal only covers input aimed at other applications. A click elsewhere in your own application still reaches it as usual, so closing the popup in that case is up to you. Nested grabbing popups must be closed in the reverse order they were opened.

Trait Implementations

impl Clone for PopupOptions

fn clone(&self) -> PopupOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PopupOptions

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

Formats the value using the given formatter.

impl Eq for PopupOptions

impl PartialEq for PopupOptions

fn eq(&self, other: &PopupOptions) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PopupOptions