Struct CaptionButtons 

pub struct CaptionButtons { /* private fields */ }

The caption buttons over the trailing end of a title bar, above any dialog, or nothing where the system draws them. Render it once per window, as a child of the root; a super::TitleBar renders its own, so a window with one needs no other.

CaptionButtons::preview instead draws them in place, e.g. in a catalog page: inert, in the page’s flow, never over the real title bar.

Implementations

impl CaptionButtons

pub fn new(height: Pixels, labels: CaptionLabels) -> Self

Buttons for a title bar height tall, announced with labels.

pub fn preview(self, id: impl Into<ElementId>) -> Self

Draw the buttons inline, where the parent lays them out, instead of pinning them to the window’s top-right corner above every dialog. A preview shows minimize, maximize and close for its caption style (nothing for Caption::System) and keeps the hover and press states, but its buttons are not window control areas and do not act on the window. id keeps several previews in one window apart.

pub fn labels(self, labels: CaptionLabels) -> Self

pub fn caption(self, caption: Caption) -> Self

Force a caption style instead of detecting it, e.g. for screenshots.

pub fn on_close( self, request: impl Fn(&mut Window, &mut App) -> bool + 'static, ) -> Self

Asked before the Linux close button removes the window; return false to keep it (e.g. to save first). Windows routes close through the system, which the application observes as a window close.

pub fn width(window: &Window) -> f32

The width the buttons take from the title bar’s trailing edge.

pub fn trailing(window: &Window) -> f32

Where the title bar’s own content should end: before the buttons with a little open space, or a 16px inset where the system draws them.

Trait Implementations

impl IntoElement for CaptionButtons

type Element = ViewElement<CaptionButtons>

The specific type of element into which the implementing type is converted. Useful for converting other types into elements automatically, like Strings

fn into_element(self) -> Self::Element

Convert self into a type that implements [Element].

fn into_any_element(self) -> AnyElement

Convert self into a dynamically-typed [AnyElement].

impl RenderOnce for CaptionButtons

fn render(self, window: &mut Window, _: &mut App) -> impl IntoElement

Render this component into an element tree. Note that this method takes ownership of self, as compared to [Render::render()] method which takes a mutable reference.