pub struct RunOptions {
pub window_attributes: WindowAttributes,
pub presentation_mode: PresentationMode,
pub font_family: Option<FontFamily>,
pub monospace_family: Option<FontFamily>,
pub main_window: WindowKey,
pub exit_policy: ExitPolicy,
pub web: WebOptions,
pub accessibility: bool,
}Expand description
Native window configuration. Sizes in WindowAttributes may be logical or physical.
On macOS the runner always enables system decorations for native controls and resizing.
window_attributes and presentation_mode describe the main window. Other windows use
WindowOptions.
Fields§
§window_attributes: WindowAttributes§presentation_mode: PresentationMode§font_family: Option<FontFamily>Replaces the bundled Inter family for every window. System fonts and color emoji still supply scripts the family lacks.
monospace_family: Option<FontFamily>Replaces the bundled JetBrains Mono used by monospace text, independently of
font_family. Without the bundled-monospace feature and without this, monospace
text uses the system’s generic monospace font.
main_window: WindowKeyKey of the first window. Default: WindowKey::main.
exit_policy: ExitPolicyWhat closing the main window does. Default: ExitPolicy::MainWindow.
web: WebOptionsCanvas and graphics API in a browser. Native runners ignore it.
accessibility: boolServe an accessibility tree to assistive technology. Default: on. Nothing is built until a screen reader connects, so leaving it on costs nothing without one.
Implementations§
Source§impl RunOptions
impl RunOptions
Sourcepub fn with_font_family(self, family: FontFamily) -> Self
pub fn with_font_family(self, family: FontFamily) -> Self
Use family for all text instead of the bundled Inter, without building
a custom host around Context::with_fonts.
Sourcepub fn with_monospace_family(self, family: FontFamily) -> Self
pub fn with_monospace_family(self, family: FontFamily) -> Self
Use family for monospace text instead of the bundled JetBrains Mono.
Sourcepub fn with_exit_policy(self, policy: ExitPolicy) -> Self
pub fn with_exit_policy(self, policy: ExitPolicy) -> Self
Choose whether the application ends with the main window or with the last window.
Sourcepub fn with_accessibility(self, accessibility: bool) -> Self
pub fn with_accessibility(self, accessibility: bool) -> Self
Turn the accessibility integration off (or back on) for every window; see
WindowOptions::with_accessibility for one window. Has no effect without the
accesskit feature or in a browser, where there is no integration.
Sourcepub fn with_main_window(self, key: impl Into<WindowKey>) -> Self
pub fn with_main_window(self, key: impl Into<WindowKey>) -> Self
Name the main window, for applications that address it by a key of their own.
Sourcepub fn with_canvas_id(self, id: impl Into<String>) -> Self
pub fn with_canvas_id(self, id: impl Into<String>) -> Self
Draw on the <canvas id="..."> of the page instead of creating one. Browser only.
Sourcepub fn with_container_id(self, id: impl Into<String>) -> Self
pub fn with_container_id(self, id: impl Into<String>) -> Self
Put the canvas the runner creates into the element with this id and fill it,
instead of covering the browser window. Browser only.
Sourcepub fn with_web_backend(self, backend: WebBackend) -> Self
pub fn with_web_backend(self, backend: WebBackend) -> Self
Choose WebGPU or WebGL2 in a browser. Browser only.
Sourcepub fn with_rounded_corners(self, rounded: bool) -> Self
pub fn with_rounded_corners(self, rounded: bool) -> Self
Request native rounded corners and the system shadow on Windows 11.
Applies to undecorated windows as well. Maximized/snapped windows follow
the OS policy. On other platforms this leaves window attributes unchanged.
Call after setting window_attributes. Secondary windows choose their own with
WindowOptions::with_rounded_corners.
Trait Implementations§
Source§impl Clone for RunOptions
impl Clone for RunOptions
Source§impl Debug for RunOptions
impl Debug for RunOptions
Auto Trait Implementations§
impl !RefUnwindSafe for RunOptions
impl !UnwindSafe for RunOptions
impl Freeze for RunOptions
impl Send for RunOptions
impl Sync for RunOptions
impl Unpin for RunOptions
impl UnsafeUnpin for RunOptions
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
Source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can
then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.Source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be
further downcast into Rc<ConcreteType> where ConcreteType implements Trait.Source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &Any’s vtable from &Trait’s.Source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &mut Any’s vtable from &mut Trait’s.