abstreet/rustdoc/widgetry/widgets/button/struct.ButtonBuilder.html
2022-04-08 09:17:12 +00:00

159 lines
88 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="API documentation for the Rust `ButtonBuilder` struct in crate `widgetry`."><meta name="keywords" content="rust, rustlang, rust-lang, ButtonBuilder"><title>ButtonBuilder in widgetry::widgets::button - Rust</title><link rel="preload" as="font" type="font/woff2" crossorigin href="../../../SourceSerif4-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../../FiraSans-Regular.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../../FiraSans-Medium.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../../SourceCodePro-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../../SourceSerif4-Bold.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../../SourceCodePro-Semibold.ttf.woff2"><link rel="stylesheet" type="text/css" href="../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../ayu.css" disabled><link rel="stylesheet" type="text/css" href="../../../dark.css" disabled><link rel="stylesheet" type="text/css" href="../../../light.css" id="themeStyle"><script id="default-settings" ></script><script src="../../../storage.js"></script><script src="../../../crates.js"></script><script defer src="../../../main.js"></script>
<noscript><link rel="stylesheet" href="../../../noscript.css"></noscript><link rel="alternate icon" type="image/png" href="../../../favicon-16x16.png"><link rel="alternate icon" type="image/png" href="../../../favicon-32x32.png"><link rel="icon" type="image/svg+xml" href="../../../favicon.svg"></head><body class="rustdoc struct"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="mobile-topbar"><button class="sidebar-menu-toggle">&#9776;</button><a class="sidebar-logo" href="../../../widgetry/index.html"><div class="logo-container"><img class="rust-logo" src="../../../rust-logo.svg" alt="logo"></div>
</a><h2 class="location"></h2>
</nav>
<nav class="sidebar"><a class="sidebar-logo" href="../../../widgetry/index.html"><div class="logo-container"><img class="rust-logo" src="../../../rust-logo.svg" alt="logo"></div>
</a><h2 class="location"><a href="#">ButtonBuilder</a></h2><div class="sidebar-elems"><section><div class="block"><h3 class="sidebar-title"><a href="#fields">Fields</a></h3><ul><li><a href="#structfield.corner_rounding">corner_rounding</a></li><li><a href="#structfield.default_style">default_style</a></li><li><a href="#structfield.disable_style">disable_style</a></li><li><a href="#structfield.disabled_tooltip">disabled_tooltip</a></li><li><a href="#structfield.hotkey">hotkey</a></li><li><a href="#structfield.hover_style">hover_style</a></li><li><a href="#structfield.is_disabled">is_disabled</a></li><li><a href="#structfield.is_label_before_image">is_label_before_image</a></li><li><a href="#structfield.padding">padding</a></li><li><a href="#structfield.stack_axis">stack_axis</a></li><li><a href="#structfield.stack_spacing">stack_spacing</a></li><li><a href="#structfield.tooltip">tooltip</a></li></ul></div><div class="block"><h3 class="sidebar-title"><a href="#implementations">Methods</a></h3><ul><li><a href="#method.batch">batch</a></li><li><a href="#method.bg_color">bg_color</a></li><li><a href="#method.build">build</a></li><li><a href="#method.build_def">build_def</a></li><li><a href="#method.build_widget">build_widget</a></li><li><a href="#method.corner_rounding">corner_rounding</a></li><li><a href="#method.custom_batch">custom_batch</a></li><li><a href="#method.disabled">disabled</a></li><li><a href="#method.disabled_tooltip">disabled_tooltip</a></li><li><a href="#method.font">font</a></li><li><a href="#method.font_size">font_size</a></li><li><a href="#method.horizontal">horizontal</a></li><li><a href="#method.hotkey">hotkey</a></li><li><a href="#method.image">image</a></li><li><a href="#method.image_batch">image_batch</a></li><li><a href="#method.image_bg_color">image_bg_color</a></li><li><a href="#method.image_bytes">image_bytes</a></li><li><a href="#method.image_color">image_color</a></li><li><a href="#method.image_content_mode">image_content_mode</a></li><li><a href="#method.image_corner_rounding">image_corner_rounding</a></li><li><a href="#method.image_dims">image_dims</a></li><li><a href="#method.image_first">image_first</a></li><li><a href="#method.image_padding">image_padding</a></li><li><a href="#method.image_path">image_path</a></li><li><a href="#method.label_color">label_color</a></li><li><a href="#method.label_first">label_first</a></li><li><a href="#method.label_styled_text">label_styled_text</a></li><li><a href="#method.label_text">label_text</a></li><li><a href="#method.label_underlined_text">label_underlined_text</a></li><li><a href="#method.new">new</a></li><li><a href="#method.no_tooltip">no_tooltip</a></li><li><a href="#method.outline">outline</a></li><li><a href="#method.outline_color">outline_color</a></li><li><a href="#method.override_style">override_style</a></li><li><a href="#method.padding">padding</a></li><li><a href="#method.padding_bottom">padding_bottom</a></li><li><a href="#method.padding_left">padding_left</a></li><li><a href="#method.padding_right">padding_right</a></li><li><a href="#method.padding_top">padding_top</a></li><li><a href="#method.stack_spacing">stack_spacing</a></li><li><a href="#method.style">style</a></li><li><a href="#method.style_mut">style_mut</a></li><li><a href="#method.tooltip">tooltip</a></li><li><a href="#method.vertical">vertical</a></li></ul></div><div class="block"><h3 class="sidebar-title"><a href="#trait-implementations">Trait Implementations</a></h3><ul><li><a href="#impl-Clone">Clone</a></li><li><a href="#impl-Debug">Debug</a></li><li><a href="#impl-Default">Default</a></li></ul></div><div class="block"><h3 class="sidebar-title"><a href="#synthetic-implementations">Auto Trait Implementations</a></h3><ul><li><a href="#impl-RefUnwindSafe">RefUnwindSafe</a></li><li><a href="#impl-Send">Send</a></li><li><a href="#impl-Sync">Sync</a></li><li><a href="#impl-Unpin">Unpin</a></li><li><a href="#impl-UnwindSafe">UnwindSafe</a></li></ul></div><div class="block"><h3 class="sidebar-title"><a href="#blanket-implementations">Blanket Implementations</a></h3><ul><li><a href="#impl-Any">Any</a></li><li><a href="#impl-Borrow%3CT%3E">Borrow&lt;T&gt;</a></li><li><a href="#impl-BorrowMut%3CT%3E">BorrowMut&lt;T&gt;</a></li><li><a href="#impl-Downcast">Downcast</a></li><li><a href="#impl-DowncastSync">DowncastSync</a></li><li><a href="#impl-From%3CT%3E">From&lt;T&gt;</a></li><li><a href="#impl-Instrument">Instrument</a></li><li><a href="#impl-Into%3CU%3E">Into&lt;U&gt;</a></li><li><a href="#impl-Same%3CT%3E">Same&lt;T&gt;</a></li><li><a href="#impl-ToOwned">ToOwned</a></li><li><a href="#impl-TryFrom%3CU%3E">TryFrom&lt;U&gt;</a></li><li><a href="#impl-TryInto%3CU%3E">TryInto&lt;U&gt;</a></li></ul></div></section><h2 class="location"><a href="index.html">In widgetry::widgets::button</a></h2><div id="sidebar-vars" data-name="ButtonBuilder" data-ty="struct" data-relpath=""></div><script defer src="sidebar-items.js"></script></div></nav><main><div class="width-limiter"><div class="sub-container"><a class="sub-logo-container" href="../../../widgetry/index.html"><img class="rust-logo" src="../../../rust-logo.svg" alt="logo"></a><nav class="sub"><div class="theme-picker hidden"><button id="theme-picker" aria-label="Pick another theme!" aria-haspopup="menu" title="themes"><img width="22" height="22" alt="Pick another theme!" src="../../../brush.svg"></button><div id="theme-choices" role="menu"></div></div><form class="search-form"><div class="search-container"><span></span><input class="search-input" name="search" autocomplete="off" spellcheck="false" placeholder="Click or press S to search, ? for more options…" type="search"><button type="button" id="help-button" title="help">?</button><a id="settings-menu" href="../../../settings.html" title="settings"><img width="22" height="22" alt="Change settings" src="../../../wheel.svg"></a></div></form></nav></div><section id="main-content" class="content"><div class="main-heading">
<h1 class="fqn"><span class="in-band">Struct <a href="../../index.html">widgetry</a>::<wbr><a href="../index.html">widgets</a>::<wbr><a href="index.html">button</a>::<wbr><a class="struct" href="#">ButtonBuilder</a><button id="copy-path" onclick="copy_path(this)" title="Copy item path to clipboard"><img src="../../../clipboard.svg" width="19" height="18" alt="Copy item path"></button></span></h1><span class="out-of-band"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#145-158">source</a> · <a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">&#x2212;</span>]</a></span></div><div class="docblock item-decl"><pre class="rust struct"><code>pub struct ButtonBuilder&lt;'a, 'c&gt; {
padding: <a class="struct" href="../struct.EdgeInsets.html" title="struct widgetry::widgets::EdgeInsets">EdgeInsets</a>,
stack_spacing: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.f64.html">f64</a>,
hotkey: <a class="enum" href="https://doc.rust-lang.org/1.60.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="enum" href="../../event/enum.MultiKey.html" title="enum widgetry::event::MultiKey">MultiKey</a>&gt;,
tooltip: <a class="enum" href="https://doc.rust-lang.org/1.60.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="../../text/struct.Text.html" title="struct widgetry::text::Text">Text</a>&gt;,
stack_axis: <a class="enum" href="https://doc.rust-lang.org/1.60.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="enum" href="../../geom/geom_batch_stack/enum.Axis.html" title="enum widgetry::geom::geom_batch_stack::Axis">Axis</a>&gt;,
is_label_before_image: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.bool.html">bool</a>,
corner_rounding: <a class="enum" href="https://doc.rust-lang.org/1.60.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="enum" href="../enum.CornerRounding.html" title="enum widgetry::widgets::CornerRounding">CornerRounding</a>&gt;,
is_disabled: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.bool.html">bool</a>,
default_style: <a class="struct" href="struct.ButtonStateStyle.html" title="struct widgetry::widgets::button::ButtonStateStyle">ButtonStateStyle</a>&lt;'a, 'c&gt;,
hover_style: <a class="struct" href="struct.ButtonStateStyle.html" title="struct widgetry::widgets::button::ButtonStateStyle">ButtonStateStyle</a>&lt;'a, 'c&gt;,
disable_style: <a class="struct" href="struct.ButtonStateStyle.html" title="struct widgetry::widgets::button::ButtonStateStyle">ButtonStateStyle</a>&lt;'a, 'c&gt;,
disabled_tooltip: <a class="enum" href="https://doc.rust-lang.org/1.60.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="../../text/struct.Text.html" title="struct widgetry::text::Text">Text</a>&gt;,
}</code></pre></div><h2 id="fields" class="fields small-section-header">Fields<a href="#fields" class="anchor"></a></h2><span id="structfield.padding" class="structfield small-section-header"><a href="#structfield.padding" class="anchor field"></a><code>padding: <a class="struct" href="../struct.EdgeInsets.html" title="struct widgetry::widgets::EdgeInsets">EdgeInsets</a></code></span><span id="structfield.stack_spacing" class="structfield small-section-header"><a href="#structfield.stack_spacing" class="anchor field"></a><code>stack_spacing: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.f64.html">f64</a></code></span><span id="structfield.hotkey" class="structfield small-section-header"><a href="#structfield.hotkey" class="anchor field"></a><code>hotkey: <a class="enum" href="https://doc.rust-lang.org/1.60.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="enum" href="../../event/enum.MultiKey.html" title="enum widgetry::event::MultiKey">MultiKey</a>&gt;</code></span><span id="structfield.tooltip" class="structfield small-section-header"><a href="#structfield.tooltip" class="anchor field"></a><code>tooltip: <a class="enum" href="https://doc.rust-lang.org/1.60.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="../../text/struct.Text.html" title="struct widgetry::text::Text">Text</a>&gt;</code></span><span id="structfield.stack_axis" class="structfield small-section-header"><a href="#structfield.stack_axis" class="anchor field"></a><code>stack_axis: <a class="enum" href="https://doc.rust-lang.org/1.60.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="enum" href="../../geom/geom_batch_stack/enum.Axis.html" title="enum widgetry::geom::geom_batch_stack::Axis">Axis</a>&gt;</code></span><span id="structfield.is_label_before_image" class="structfield small-section-header"><a href="#structfield.is_label_before_image" class="anchor field"></a><code>is_label_before_image: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.bool.html">bool</a></code></span><span id="structfield.corner_rounding" class="structfield small-section-header"><a href="#structfield.corner_rounding" class="anchor field"></a><code>corner_rounding: <a class="enum" href="https://doc.rust-lang.org/1.60.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="enum" href="../enum.CornerRounding.html" title="enum widgetry::widgets::CornerRounding">CornerRounding</a>&gt;</code></span><span id="structfield.is_disabled" class="structfield small-section-header"><a href="#structfield.is_disabled" class="anchor field"></a><code>is_disabled: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.bool.html">bool</a></code></span><span id="structfield.default_style" class="structfield small-section-header"><a href="#structfield.default_style" class="anchor field"></a><code>default_style: <a class="struct" href="struct.ButtonStateStyle.html" title="struct widgetry::widgets::button::ButtonStateStyle">ButtonStateStyle</a>&lt;'a, 'c&gt;</code></span><span id="structfield.hover_style" class="structfield small-section-header"><a href="#structfield.hover_style" class="anchor field"></a><code>hover_style: <a class="struct" href="struct.ButtonStateStyle.html" title="struct widgetry::widgets::button::ButtonStateStyle">ButtonStateStyle</a>&lt;'a, 'c&gt;</code></span><span id="structfield.disable_style" class="structfield small-section-header"><a href="#structfield.disable_style" class="anchor field"></a><code>disable_style: <a class="struct" href="struct.ButtonStateStyle.html" title="struct widgetry::widgets::button::ButtonStateStyle">ButtonStateStyle</a>&lt;'a, 'c&gt;</code></span><span id="structfield.disabled_tooltip" class="structfield small-section-header"><a href="#structfield.disabled_tooltip" class="anchor field"></a><code>disabled_tooltip: <a class="enum" href="https://doc.rust-lang.org/1.60.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="struct" href="../../text/struct.Text.html" title="struct widgetry::text::Text">Text</a>&gt;</code></span><h2 id="implementations" class="small-section-header">Implementations<a href="#implementations" class="anchor"></a></h2><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl" class="impl has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#170-733">source</a></span><a href="#impl" class="anchor"></a><h3 class="code-header in-band">impl&lt;'b, 'a: 'b, 'c&gt; <a class="struct" href="struct.ButtonBuilder.html" title="struct widgetry::widgets::button::ButtonBuilder">ButtonBuilder</a>&lt;'a, 'c&gt;</h3></section></summary><div class="impl-items"><section id="method.new" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#171-182">source</a></span><a href="#method.new" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.new" class="fnname">new</a>() -&gt; Self</h4></section><details class="rustdoc-toggle method-toggle" open><summary><section id="method.padding" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#194-197">source</a></span><a href="#method.padding" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.padding" class="fnname">padding</a>&lt;EI:&nbsp;<a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;<a class="struct" href="../struct.EdgeInsets.html" title="struct widgetry::widgets::EdgeInsets">EdgeInsets</a>&gt;&gt;(self, padding: EI) -&gt; Self</h4></section></summary><div class="docblock"><p>Extra spacing around a buttons items (label and/or image).</p>
<p>If not specified, a default will be applied.</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="comment">// Custom padding for each inset</span>
<span class="kw">let</span> <span class="ident">b</span> <span class="op">=</span> <span class="ident">ButtonBuilder::new</span>().<span class="ident">padding</span>(<span class="ident">EdgeInsets</span>{ <span class="ident">top</span>: <span class="number">1.0</span>, <span class="ident">bottom</span>: <span class="number">2.0</span>, <span class="ident">left</span>: <span class="number">12.0</span>, <span class="ident">right</span>: <span class="number">14.0</span> });
<span class="comment">// uniform padding</span>
<span class="kw">let</span> <span class="ident">b</span> <span class="op">=</span> <span class="ident">ButtonBuilder::new</span>().<span class="ident">padding</span>(<span class="number">6</span>);</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.padding_top" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#200-203">source</a></span><a href="#method.padding_top" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.padding_top" class="fnname">padding_top</a>(self, padding: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.f64.html">f64</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>Extra spacing around a buttons items (label and/or image).</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.padding_left" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#206-209">source</a></span><a href="#method.padding_left" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.padding_left" class="fnname">padding_left</a>(self, padding: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.f64.html">f64</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>Extra spacing around a buttons items (label and/or image).</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.padding_bottom" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#212-215">source</a></span><a href="#method.padding_bottom" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.padding_bottom" class="fnname">padding_bottom</a>(self, padding: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.f64.html">f64</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>Extra spacing around a buttons items (label and/or image).</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.padding_right" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#218-221">source</a></span><a href="#method.padding_right" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.padding_right" class="fnname">padding_right</a>(self, padding: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.f64.html">f64</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>Extra spacing around a buttons items (label and/or image).</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.label_text" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#226-231">source</a></span><a href="#method.label_text" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.label_text" class="fnname">label_text</a>&lt;I:&nbsp;<a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;<a class="struct" href="https://doc.rust-lang.org/1.60.0/alloc/string/struct.String.html" title="struct alloc::string::String">String</a>&gt;&gt;(self, text: I) -&gt; Self</h4></section></summary><div class="docblock"><p>Set the text of the buttons label.</p>
<p>If <code>label_text</code> is not set, the button will not have a label.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.label_underlined_text" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#236-243">source</a></span><a href="#method.label_underlined_text" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.label_underlined_text" class="fnname">label_underlined_text</a>&lt;I:&nbsp;<a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;<a class="struct" href="https://doc.rust-lang.org/1.60.0/alloc/string/struct.String.html" title="struct alloc::string::String">String</a>&gt;&gt;(self, text: I) -&gt; Self</h4></section></summary><div class="docblock"><p>Set the text of the buttons label. The text will be decorated with an underline.</p>
<p>See <code>label_styled_text</code> if you need something more customizable text styling.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.label_styled_text" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#247-257">source</a></span><a href="#method.label_styled_text" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.label_styled_text" class="fnname">label_styled_text</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;self, <br>&nbsp;&nbsp;&nbsp;&nbsp;styled_text: <a class="struct" href="../../text/struct.Text.html" title="struct widgetry::text::Text">Text</a>, <br>&nbsp;&nbsp;&nbsp;&nbsp;for_state: <a class="enum" href="../../enum.ControlState.html" title="enum widgetry::ControlState">ControlState</a><br>) -&gt; Self</h4></section></summary><div class="docblock"><p>Assign a pre-styled <code>Text</code> instance if your button need something more than uniformly
colored text.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.label_color" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#262-268">source</a></span><a href="#method.label_color" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.label_color" class="fnname">label_color</a>(self, color: <a class="struct" href="../../color/struct.Color.html" title="struct widgetry::color::Color">Color</a>, for_state: <a class="enum" href="../../enum.ControlState.html" title="enum widgetry::ControlState">ControlState</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>Set the color of the buttons label.</p>
<p>If not specified, a default font color will be used.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.font" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#273-278">source</a></span><a href="#method.font" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.font" class="fnname">font</a>(self, font: <a class="enum" href="../../text/enum.Font.html" title="enum widgetry::text::Font">Font</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>Set the font used by the buttons label.</p>
<p>If not specified, a default font will be used.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.font_size" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#283-288">source</a></span><a href="#method.font_size" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.font_size" class="fnname">font_size</a>(self, font_size: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.usize.html">usize</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>Set the size of the font of the buttons label.</p>
<p>If not specified, a default font size will be used.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.image_path" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#293-300">source</a></span><a href="#method.image_path" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.image_path" class="fnname">image_path</a>(self, path: &amp;'a <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.str.html">str</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>Set the image for the button. If not set, the button will have no image.</p>
<p>This will replace any image previously set.</p>
</div></details><section id="method.image" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#302-307">source</a></span><a href="#method.image" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.image" class="fnname">image</a>(self, image: <a class="struct" href="../image/struct.Image.html" title="struct widgetry::widgets::image::Image">Image</a>&lt;'a, 'c&gt;) -&gt; Self</h4></section><details class="rustdoc-toggle method-toggle" open><summary><section id="method.image_bytes" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#317-324">source</a></span><a href="#method.image_bytes" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.image_bytes" class="fnname">image_bytes</a>(self, labeled_bytes: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.tuple.html">(</a>&amp;'a <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.str.html">str</a>, <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.slice.html">&amp;'a [</a><a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.u8.html">u8</a><a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.slice.html">]</a><a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.tuple.html">)</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>Set the image for the button. If not set, the button will have no image.</p>
<p>This will replace any image previously set.</p>
<ul>
<li><code>labeled_bytes</code>: is a (<code>label</code>, <code>bytes</code>) tuple you can generate with
<a href="../../macro.include_labeled_bytes.html" title="include_labeled_bytes!"><code>include_labeled_bytes!</code></a></li>
<li><code>label</code>: a label to describe the bytes for debugging purposes</li>
<li><code>bytes</code>: UTF-8 encoded bytes of the SVG</li>
</ul>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.image_batch" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#332-337">source</a></span><a href="#method.image_batch" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.image_batch" class="fnname">image_batch</a>(self, batch: <a class="struct" href="../../geom/struct.GeomBatch.html" title="struct widgetry::geom::GeomBatch">GeomBatch</a>, bounds: <a class="struct" href="../../../geom/bounds/struct.Bounds.html" title="struct geom::bounds::Bounds">Bounds</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>Set the image for the button. If not set, the button will have no image.</p>
<p>This will replace any image previously set.</p>
<p>This method is useful when doing more complex transforms. For example, to re-write more than
one color for your button image, do so externally and pass in the resultant GeomBatch here.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.image_color" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#345-351">source</a></span><a href="#method.image_color" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.image_color" class="fnname">image_color</a>&lt;C:&nbsp;<a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;<a class="enum" href="../../geom/enum.RewriteColor.html" title="enum widgetry::geom::RewriteColor">RewriteColor</a>&gt;&gt;(<br>&nbsp;&nbsp;&nbsp;&nbsp;self, <br>&nbsp;&nbsp;&nbsp;&nbsp;color: C, <br>&nbsp;&nbsp;&nbsp;&nbsp;for_state: <a class="enum" href="../../enum.ControlState.html" title="enum widgetry::ControlState">ControlState</a><br>) -&gt; Self</h4></section></summary><div class="docblock"><p>Rewrite the color of the buttons image.</p>
<p>This has no effect if the button does not have an image.</p>
<p>If the style hasnt been set for the current ControlState, the style for
<code>ControlState::Default</code> will be used.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.image_bg_color" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#359-365">source</a></span><a href="#method.image_bg_color" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.image_bg_color" class="fnname">image_bg_color</a>(self, color: <a class="struct" href="../../color/struct.Color.html" title="struct widgetry::color::Color">Color</a>, for_state: <a class="enum" href="../../enum.ControlState.html" title="enum widgetry::ControlState">ControlState</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>Set a background color for the image, other than the buttons background.</p>
<p>This has no effect if the button does not have an image.</p>
<p>If the style hasnt been set for the current ControlState, the style for
<code>ControlState::Default</code> will be used.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.image_dims" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#372-377">source</a></span><a href="#method.image_dims" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.image_dims" class="fnname">image_dims</a>&lt;D:&nbsp;<a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;<a class="struct" href="../../screen_geom/struct.ScreenDims.html" title="struct widgetry::screen_geom::ScreenDims">ScreenDims</a>&gt;&gt;(self, dims: D) -&gt; Self</h4></section></summary><div class="docblock"><p>Scale the bounds containing the image. If <code>image_dims</code> are not specified, the images
intrinsic size will be used.</p>
<p>See <a href="struct.ButtonBuilder.html#method.image_content_mode" title="ButtonBuilder::image_content_mode"><code>ButtonBuilder::image_content_mode</code></a> to control how the image scales to fit
its custom bounds.</p>
</div></details><section id="method.override_style" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#379-381">source</a></span><a href="#method.override_style" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.override_style" class="fnname">override_style</a>(self, style: &amp;<a class="struct" href="../../style/button_style/struct.ButtonStyle.html" title="struct widgetry::style::button_style::ButtonStyle">ButtonStyle</a>) -&gt; Self</h4></section><details class="rustdoc-toggle method-toggle" open><summary><section id="method.image_content_mode" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#390-395">source</a></span><a href="#method.image_content_mode" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.image_content_mode" class="fnname">image_content_mode</a>(self, content_mode: <a class="enum" href="../../enum.ContentMode.html" title="enum widgetry::ContentMode">ContentMode</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>If a custom <code>image_dims</code> was set, control how the image should be scaled to its new bounds</p>
<p>If <code>image_dims</code> were not specified, the image will not be scaled, so content_mode has no
affect.</p>
<p>The default, <a href="../../enum.ContentMode.html#variant.ScaleAspectFit" title="ContentMode::ScaleAspectFit"><code>ContentMode::ScaleAspectFit</code></a> will only grow as much as it can while
maintaining its aspect ratio and not exceeding its bounds.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.image_corner_rounding" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#398-403">source</a></span><a href="#method.image_corner_rounding" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.image_corner_rounding" class="fnname">image_corner_rounding</a>&lt;R:&nbsp;<a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;<a class="enum" href="../enum.CornerRounding.html" title="enum widgetry::widgets::CornerRounding">CornerRounding</a>&gt;&gt;(self, value: R) -&gt; Self</h4></section></summary><div class="docblock"><p>Set independent rounding for each of the buttons images corners</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.image_padding" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#406-411">source</a></span><a href="#method.image_padding" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.image_padding" class="fnname">image_padding</a>&lt;EI:&nbsp;<a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;<a class="struct" href="../struct.EdgeInsets.html" title="struct widgetry::widgets::EdgeInsets">EdgeInsets</a>&gt;&gt;(self, value: EI) -&gt; Self</h4></section></summary><div class="docblock"><p>Set padding for the image</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.bg_color" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#417-420">source</a></span><a href="#method.bg_color" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.bg_color" class="fnname">bg_color</a>(self, color: <a class="struct" href="../../color/struct.Color.html" title="struct widgetry::color::Color">Color</a>, for_state: <a class="enum" href="../../enum.ControlState.html" title="enum widgetry::ControlState">ControlState</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>Set a background color for the button based on the buttons <a href="../../enum.ControlState.html" title="ControlState"><code>ControlState</code></a>.</p>
<p>If the style hasnt been set for the current ControlState, the style for
<code>ControlState::Default</code> will be used.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.outline" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#426-429">source</a></span><a href="#method.outline" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.outline" class="fnname">outline</a>(self, outline: <a class="type" href="../../style/type.OutlineStyle.html" title="type widgetry::style::OutlineStyle">OutlineStyle</a>, for_state: <a class="enum" href="../../enum.ControlState.html" title="enum widgetry::ControlState">ControlState</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>Set an outline for the button based on the buttons <a href="../../enum.ControlState.html" title="ControlState"><code>ControlState</code></a>.</p>
<p>If the style hasnt been set for the current ControlState, the style for
<code>ControlState::Default</code> will be used.</p>
</div></details><section id="method.outline_color" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#431-441">source</a></span><a href="#method.outline_color" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.outline_color" class="fnname">outline_color</a>(self, color: <a class="struct" href="../../color/struct.Color.html" title="struct widgetry::color::Color">Color</a>, for_state: <a class="enum" href="../../enum.ControlState.html" title="enum widgetry::ControlState">ControlState</a>) -&gt; Self</h4></section><details class="rustdoc-toggle method-toggle" open><summary><section id="method.custom_batch" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#447-450">source</a></span><a href="#method.custom_batch" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.custom_batch" class="fnname">custom_batch</a>(self, batch: <a class="struct" href="../../geom/struct.GeomBatch.html" title="struct widgetry::geom::GeomBatch">GeomBatch</a>, for_state: <a class="enum" href="../../enum.ControlState.html" title="enum widgetry::ControlState">ControlState</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>Set a pre-rendered <a href="../../geom/struct.GeomBatch.html" title="GeomBatch">GeomBatch</a> to use for the button instead of individual fields.</p>
<p>This is useful for applying one-off button designs that cant be accommodated by the
the existing ButtonBuilder methods.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.hotkey" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#453-456">source</a></span><a href="#method.hotkey" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.hotkey" class="fnname">hotkey</a>&lt;MK:&nbsp;<a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;<a class="enum" href="https://doc.rust-lang.org/1.60.0/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="enum" href="../../event/enum.MultiKey.html" title="enum widgetry::event::MultiKey">MultiKey</a>&gt;&gt;&gt;(self, key: MK) -&gt; Self</h4></section></summary><div class="docblock"><p>Set a hotkey for the button</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.tooltip" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#461-464">source</a></span><a href="#method.tooltip" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.tooltip" class="fnname">tooltip</a>(self, tooltip: impl <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;<a class="struct" href="../../text/struct.Text.html" title="struct widgetry::text::Text">Text</a>&gt;) -&gt; Self</h4></section></summary><div class="docblock"><p>Set a non-default tooltip <a href="../../text/struct.Text.html" title="Text"><code>Text</code></a> to appear when hovering over the button.</p>
<p>If a <code>tooltip</code> is not specified, a default tooltip will be applied.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.no_tooltip" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#468-472">source</a></span><a href="#method.no_tooltip" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.no_tooltip" class="fnname">no_tooltip</a>(self) -&gt; Self</h4></section></summary><div class="docblock"><p>If a <code>tooltip</code> is not specified, a default tooltip will be applied. Use <code>no_tooltip</code> when
you do not want even the default tooltip to appear.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.disabled_tooltip" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#478-481">source</a></span><a href="#method.disabled_tooltip" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.disabled_tooltip" class="fnname">disabled_tooltip</a>(self, tooltip: impl <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;<a class="struct" href="../../text/struct.Text.html" title="struct widgetry::text::Text">Text</a>&gt;) -&gt; Self</h4></section></summary><div class="docblock"><p>Set a tooltip <a href="../../text/struct.Text.html" title="Text"><code>Text</code></a> to appear when hovering over the button, when the button is
disabled.</p>
<p>This tooltip is only displayed when <code>disabled(true)</code> is also called.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.vertical" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#486-489">source</a></span><a href="#method.vertical" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.vertical" class="fnname">vertical</a>(self) -&gt; Self</h4></section></summary><div class="docblock"><p>The buttons items will be rendered in a vertical column</p>
<p>If the button doesnt have both an image and label, this has no effect.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.horizontal" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#494-497">source</a></span><a href="#method.horizontal" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.horizontal" class="fnname">horizontal</a>(self) -&gt; Self</h4></section></summary><div class="docblock"><p>The buttons items will be rendered in a horizontal row</p>
<p>If the button doesnt have both an image and label, this has no effect.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.disabled" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#500-503">source</a></span><a href="#method.disabled" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.disabled" class="fnname">disabled</a>(self, is_disabled: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.bool.html">bool</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>The button cannot be clicked and will be styled as <a href="../../enum.ControlState.html#variant.Disabled" title="ControlState::Disabled"><code>ControlState::Disabled</code></a></p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.label_first" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#508-511">source</a></span><a href="#method.label_first" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.label_first" class="fnname">label_first</a>(self) -&gt; Self</h4></section></summary><div class="docblock"><p>Display the buttons label before the buttons image.</p>
<p>If the button doesnt have both an image and label, this has no effect.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.image_first" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#516-519">source</a></span><a href="#method.image_first" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.image_first" class="fnname">image_first</a>(self) -&gt; Self</h4></section></summary><div class="docblock"><p>Display the buttons image before the buttons label.</p>
<p>If the button doesnt have both an image and label, this has no effect.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.stack_spacing" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#523-526">source</a></span><a href="#method.stack_spacing" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.stack_spacing" class="fnname">stack_spacing</a>(self, value: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.f64.html">f64</a>) -&gt; Self</h4></section></summary><div class="docblock"><p>Spacing between the image and text of a button.
Has no effect if the button is text-only or image-only.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.corner_rounding" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#529-532">source</a></span><a href="#method.corner_rounding" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.corner_rounding" class="fnname">corner_rounding</a>&lt;R:&nbsp;<a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;<a class="enum" href="../enum.CornerRounding.html" title="enum widgetry::widgets::CornerRounding">CornerRounding</a>&gt;&gt;(self, value: R) -&gt; Self</h4></section></summary><div class="docblock"><p>Set independent rounding for each of the buttons corners</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.build" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#556-578">source</a></span><a href="#method.build" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.build" class="fnname">build</a>(&amp;self, ctx: &amp;<a class="struct" href="../../event_ctx/struct.EventCtx.html" title="struct widgetry::event_ctx::EventCtx">EventCtx</a>&lt;'_&gt;, action: &amp;<a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.str.html">str</a>) -&gt; <a class="struct" href="struct.Button.html" title="struct widgetry::widgets::button::Button">Button</a></h4></section></summary><div class="docblock"><p>Build a button.</p>
<p><code>action</code>: The event that will be fired when clicked</p>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code>
<span class="kw">fn</span> <span class="ident">build_some_buttons</span>(<span class="ident">ctx</span>: <span class="kw-2">&amp;</span><span class="ident">EventCtx</span>) {
<span class="kw">let</span> <span class="ident">one_off_builder</span> <span class="op">=</span> <span class="ident">ButtonBuilder::new</span>().<span class="ident">label_text</span>(<span class="string">&quot;foo&quot;</span>).<span class="ident">build</span>(<span class="ident">ctx</span>, <span class="string">&quot;foo&quot;</span>);
<span class="comment">// If you&#39;d like to build a series of similar buttons, `clone` the builder first.</span>
<span class="kw">let</span> <span class="ident">red_builder</span> <span class="op">=</span> <span class="ident">ButtonBuilder::new</span>()
.<span class="ident">bg_color</span>(<span class="ident">Color::RED</span>, <span class="ident">ControlState::Default</span>)
.<span class="ident">bg_color</span>(<span class="ident">Color::RED</span>.<span class="ident">alpha</span>(<span class="number">0.3</span>), <span class="ident">ControlState::Disabled</span>)
.<span class="ident">outline</span>((<span class="number">2.0</span>, <span class="ident">Color::WHITE</span>), <span class="ident">ControlState::Default</span>);
<span class="kw">let</span> <span class="ident">red_button_1</span> <span class="op">=</span> <span class="ident">red_builder</span>.<span class="ident">clone</span>().<span class="ident">label_text</span>(<span class="string">&quot;First red button&quot;</span>).<span class="ident">build</span>(<span class="ident">ctx</span>, <span class="string">&quot;first&quot;</span>);
<span class="kw">let</span> <span class="ident">red_button_2</span> <span class="op">=</span> <span class="ident">red_builder</span>.<span class="ident">clone</span>().<span class="ident">label_text</span>(<span class="string">&quot;Second red button&quot;</span>).<span class="ident">build</span>(<span class="ident">ctx</span>, <span class="string">&quot;second&quot;</span>);
<span class="kw">let</span> <span class="ident">red_button_3</span> <span class="op">=</span> <span class="ident">red_builder</span>.<span class="ident">label_text</span>(<span class="string">&quot;Last red button&quot;</span>).<span class="ident">build</span>(<span class="ident">ctx</span>, <span class="string">&quot;third&quot;</span>);
}</code></pre></div>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.build_widget" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#583-586">source</a></span><a href="#method.build_widget" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.build_widget" class="fnname">build_widget</a>&lt;I:&nbsp;<a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.AsRef.html" title="trait core::convert::AsRef">AsRef</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.str.html">str</a>&gt;&gt;(<br>&nbsp;&nbsp;&nbsp;&nbsp;&amp;self, <br>&nbsp;&nbsp;&nbsp;&nbsp;ctx: &amp;<a class="struct" href="../../event_ctx/struct.EventCtx.html" title="struct widgetry::event_ctx::EventCtx">EventCtx</a>&lt;'_&gt;, <br>&nbsp;&nbsp;&nbsp;&nbsp;action: I<br>) -&gt; <a class="struct" href="../struct.Widget.html" title="struct widgetry::widgets::Widget">Widget</a></h4></section></summary><div class="docblock"><p>Shorthand method to build a Button wrapped in a Widget</p>
<p><code>action</code>: The event that will be fired when clicked</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.build_def" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#589-598">source</a></span><a href="#method.build_def" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.build_def" class="fnname">build_def</a>(&amp;self, ctx: &amp;<a class="struct" href="../../event_ctx/struct.EventCtx.html" title="struct widgetry::event_ctx::EventCtx">EventCtx</a>&lt;'_&gt;) -&gt; <a class="struct" href="../struct.Widget.html" title="struct widgetry::widgets::Widget">Widget</a></h4></section></summary><div class="docblock"><p>Shorthand method to build a default widget whose <code>action</code> is derived from the labels text.</p>
</div></details><section id="method.style_mut" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#602-608">source</a></span><a href="#method.style_mut" class="anchor"></a><h4 class="code-header">fn <a href="#method.style_mut" class="fnname">style_mut</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&amp;'b mut self, <br>&nbsp;&nbsp;&nbsp;&nbsp;state: <a class="enum" href="../../enum.ControlState.html" title="enum widgetry::ControlState">ControlState</a><br>) -&gt; &amp;'b mut <a class="struct" href="struct.ButtonStateStyle.html" title="struct widgetry::widgets::button::ButtonStateStyle">ButtonStateStyle</a>&lt;'a, 'c&gt;</h4></section><section id="method.style" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#610-616">source</a></span><a href="#method.style" class="anchor"></a><h4 class="code-header">fn <a href="#method.style" class="fnname">style</a>(&amp;'b self, state: <a class="enum" href="../../enum.ControlState.html" title="enum widgetry::ControlState">ControlState</a>) -&gt; &amp;'b <a class="struct" href="struct.ButtonStateStyle.html" title="struct widgetry::widgets::button::ButtonStateStyle">ButtonStateStyle</a>&lt;'a, 'c&gt;</h4></section><section id="method.batch" class="method has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#618-732">source</a></span><a href="#method.batch" class="anchor"></a><h4 class="code-header">pub fn <a href="#method.batch" class="fnname">batch</a>(&amp;self, ctx: &amp;<a class="struct" href="../../event_ctx/struct.EventCtx.html" title="struct widgetry::event_ctx::EventCtx">EventCtx</a>&lt;'_&gt;, for_state: <a class="enum" href="../../enum.ControlState.html" title="enum widgetry::ControlState">ControlState</a>) -&gt; <a class="struct" href="../../geom/struct.GeomBatch.html" title="struct widgetry::geom::GeomBatch">GeomBatch</a></h4></section></div></details><h2 id="trait-implementations" class="small-section-header">Trait Implementations<a href="#trait-implementations" class="anchor"></a></h2><div id="trait-implementations-list"><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Clone" class="impl has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#144">source</a></span><a href="#impl-Clone" class="anchor"></a><h3 class="code-header in-band">impl&lt;'a, 'c&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a> for <a class="struct" href="struct.ButtonBuilder.html" title="struct widgetry::widgets::button::ButtonBuilder">ButtonBuilder</a>&lt;'a, 'c&gt;</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.clone" class="method trait-impl has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#144">source</a></span><a href="#method.clone" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.60.0/core/clone/trait.Clone.html#tymethod.clone" class="fnname">clone</a>(&amp;self) -&gt; <a class="struct" href="struct.ButtonBuilder.html" title="struct widgetry::widgets::button::ButtonBuilder">ButtonBuilder</a>&lt;'a, 'c&gt;</h4></section></summary><div class='docblock'><p>Returns a copy of the value. <a href="https://doc.rust-lang.org/1.60.0/core/clone/trait.Clone.html#tymethod.clone">Read more</a></p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.clone_from" class="method trait-impl has-srclink"><span class="rightside"><span class="since" title="Stable since Rust version 1.0.0">1.0.0</span> · <a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/core/clone.rs.html#130">source</a></span><a href="#method.clone_from" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.60.0/core/clone/trait.Clone.html#method.clone_from" class="fnname">clone_from</a>(&amp;mut self, source: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.reference.html">&amp;</a>Self)</h4></section></summary><div class='docblock'><p>Performs copy-assignment from <code>source</code>. <a href="https://doc.rust-lang.org/1.60.0/core/clone/trait.Clone.html#method.clone_from">Read more</a></p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Debug" class="impl has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#144">source</a></span><a href="#impl-Debug" class="anchor"></a><h3 class="code-header in-band">impl&lt;'a, 'c&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/fmt/trait.Debug.html" title="trait core::fmt::Debug">Debug</a> for <a class="struct" href="struct.ButtonBuilder.html" title="struct widgetry::widgets::button::ButtonBuilder">ButtonBuilder</a>&lt;'a, 'c&gt;</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.fmt" class="method trait-impl has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#144">source</a></span><a href="#method.fmt" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.60.0/core/fmt/trait.Debug.html#tymethod.fmt" class="fnname">fmt</a>(&amp;self, f: &amp;mut <a class="struct" href="https://doc.rust-lang.org/1.60.0/core/fmt/struct.Formatter.html" title="struct core::fmt::Formatter">Formatter</a>&lt;'_&gt;) -&gt; <a class="type" href="https://doc.rust-lang.org/1.60.0/core/fmt/type.Result.html" title="type core::fmt::Result">Result</a></h4></section></summary><div class='docblock'><p>Formats the value using the given formatter. <a href="https://doc.rust-lang.org/1.60.0/core/fmt/trait.Debug.html#tymethod.fmt">Read more</a></p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Default" class="impl has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#144">source</a></span><a href="#impl-Default" class="anchor"></a><h3 class="code-header in-band">impl&lt;'a, 'c&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/default/trait.Default.html" title="trait core::default::Default">Default</a> for <a class="struct" href="struct.ButtonBuilder.html" title="struct widgetry::widgets::button::ButtonBuilder">ButtonBuilder</a>&lt;'a, 'c&gt;</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.default" class="method trait-impl has-srclink"><span class="rightside"><a class="srclink" href="../../../src/widgetry/widgets/button.rs.html#144">source</a></span><a href="#method.default" class="anchor"></a><h4 class="code-header">fn <a href="https://doc.rust-lang.org/1.60.0/core/default/trait.Default.html#tymethod.default" class="fnname">default</a>() -&gt; <a class="struct" href="struct.ButtonBuilder.html" title="struct widgetry::widgets::button::ButtonBuilder">ButtonBuilder</a>&lt;'a, 'c&gt;</h4></section></summary><div class='docblock'><p>Returns the “default value” for a type. <a href="https://doc.rust-lang.org/1.60.0/core/default/trait.Default.html#tymethod.default">Read more</a></p>
</div></details></div></details></div><h2 id="synthetic-implementations" class="small-section-header">Auto Trait Implementations<a href="#synthetic-implementations" class="anchor"></a></h2><div id="synthetic-implementations-list"><section id="impl-RefUnwindSafe" class="impl has-srclink"><a href="#impl-RefUnwindSafe" class="anchor"></a><h3 class="code-header in-band">impl&lt;'a, 'c&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/panic/unwind_safe/trait.RefUnwindSafe.html" title="trait core::panic::unwind_safe::RefUnwindSafe">RefUnwindSafe</a> for <a class="struct" href="struct.ButtonBuilder.html" title="struct widgetry::widgets::button::ButtonBuilder">ButtonBuilder</a>&lt;'a, 'c&gt;</h3></section><section id="impl-Send" class="impl has-srclink"><a href="#impl-Send" class="anchor"></a><h3 class="code-header in-band">impl&lt;'a, 'c&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> for <a class="struct" href="struct.ButtonBuilder.html" title="struct widgetry::widgets::button::ButtonBuilder">ButtonBuilder</a>&lt;'a, 'c&gt;</h3></section><section id="impl-Sync" class="impl has-srclink"><a href="#impl-Sync" class="anchor"></a><h3 class="code-header in-band">impl&lt;'a, 'c&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> for <a class="struct" href="struct.ButtonBuilder.html" title="struct widgetry::widgets::button::ButtonBuilder">ButtonBuilder</a>&lt;'a, 'c&gt;</h3></section><section id="impl-Unpin" class="impl has-srclink"><a href="#impl-Unpin" class="anchor"></a><h3 class="code-header in-band">impl&lt;'a, 'c&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/marker/trait.Unpin.html" title="trait core::marker::Unpin">Unpin</a> for <a class="struct" href="struct.ButtonBuilder.html" title="struct widgetry::widgets::button::ButtonBuilder">ButtonBuilder</a>&lt;'a, 'c&gt; <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;'a: 'c,&nbsp;</span></h3></section><section id="impl-UnwindSafe" class="impl has-srclink"><a href="#impl-UnwindSafe" class="anchor"></a><h3 class="code-header in-band">impl&lt;'a, 'c&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/panic/unwind_safe/trait.UnwindSafe.html" title="trait core::panic::unwind_safe::UnwindSafe">UnwindSafe</a> for <a class="struct" href="struct.ButtonBuilder.html" title="struct widgetry::widgets::button::ButtonBuilder">ButtonBuilder</a>&lt;'a, 'c&gt;</h3></section></div><h2 id="blanket-implementations" class="small-section-header">Blanket Implementations<a href="#blanket-implementations" class="anchor"></a></h2><div id="blanket-implementations-list"><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Any" class="impl has-srclink"><span class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/core/any.rs.html#132-136">source</a></span><a href="#impl-Any" class="anchor"></a><h3 class="code-header in-band">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/any/trait.Any.html" title="trait core::any::Any">Any</a> for T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: 'static + ?<a class="trait" href="https://doc.rust-lang.org/1.60.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,&nbsp;</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.type_id" class="method trait-impl has-srclink"><span class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/core/any.rs.html#133">source</a></span><a href="#method.type_id" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.60.0/core/any/trait.Any.html#tymethod.type_id" class="fnname">type_id</a>(&amp;self) -&gt; <a class="struct" href="https://doc.rust-lang.org/1.60.0/core/any/struct.TypeId.html" title="struct core::any::TypeId">TypeId</a></h4></section></summary><div class='docblock'><p>Gets the <code>TypeId</code> of <code>self</code>. <a href="https://doc.rust-lang.org/1.60.0/core/any/trait.Any.html#tymethod.type_id">Read more</a></p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Borrow%3CT%3E" class="impl has-srclink"><span class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/core/borrow.rs.html#209-214">source</a></span><a href="#impl-Borrow%3CT%3E" class="anchor"></a><h3 class="code-header in-band">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/borrow/trait.Borrow.html" title="trait core::borrow::Borrow">Borrow</a>&lt;T&gt; for T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: ?<a class="trait" href="https://doc.rust-lang.org/1.60.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,&nbsp;</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.borrow" class="method trait-impl has-srclink"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/91522" title="Tracking issue for const_borrow">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/core/borrow.rs.html#211">source</a></span><a href="#method.borrow" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.60.0/core/borrow/trait.Borrow.html#tymethod.borrow" class="fnname">borrow</a>(&amp;self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.reference.html">&amp;</a>T</h4></section></summary><div class='docblock'><p>Immutably borrows from an owned value. <a href="https://doc.rust-lang.org/1.60.0/core/borrow/trait.Borrow.html#tymethod.borrow">Read more</a></p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-BorrowMut%3CT%3E" class="impl has-srclink"><span class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/core/borrow.rs.html#218-222">source</a></span><a href="#impl-BorrowMut%3CT%3E" class="anchor"></a><h3 class="code-header in-band">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/borrow/trait.BorrowMut.html" title="trait core::borrow::BorrowMut">BorrowMut</a>&lt;T&gt; for T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: ?<a class="trait" href="https://doc.rust-lang.org/1.60.0/core/marker/trait.Sized.html" title="trait core::marker::Sized">Sized</a>,&nbsp;</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.borrow_mut" class="method trait-impl has-srclink"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/91522" title="Tracking issue for const_borrow">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/core/borrow.rs.html#219">source</a></span><a href="#method.borrow_mut" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.60.0/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut" class="fnname">borrow_mut</a>(&amp;mut self) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.reference.html">&amp;mut </a>T</h4></section></summary><div class='docblock'><p>Mutably borrows from an owned value. <a href="https://doc.rust-lang.org/1.60.0/core/borrow/trait.BorrowMut.html#tymethod.borrow_mut">Read more</a></p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Downcast" class="impl has-srclink"><a href="#impl-Downcast" class="anchor"></a><h3 class="code-header in-band">impl&lt;T&gt; Downcast for T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/any/trait.Any.html" title="trait core::any::Any">Any</a>,&nbsp;</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.into_any" class="method trait-impl has-srclink"><a href="#method.into_any" class="anchor"></a><h4 class="code-header">pub fn <a class="fnname">into_any</a>(self: <a class="struct" href="https://doc.rust-lang.org/1.60.0/alloc/boxed/struct.Box.html" title="struct alloc::boxed::Box">Box</a>&lt;T, <a class="struct" href="https://doc.rust-lang.org/1.60.0/alloc/alloc/struct.Global.html" title="struct alloc::alloc::Global">Global</a>&gt;) -&gt; <a class="struct" href="https://doc.rust-lang.org/1.60.0/alloc/boxed/struct.Box.html" title="struct alloc::boxed::Box">Box</a>&lt;dyn <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/any/trait.Any.html" title="trait core::any::Any">Any</a> + 'static, <a class="struct" href="https://doc.rust-lang.org/1.60.0/alloc/alloc/struct.Global.html" title="struct alloc::alloc::Global">Global</a>&gt;</h4></section></summary><div class='docblock'><p>Convert <code>Box&lt;dyn Trait&gt;</code> (where <code>Trait: Downcast</code>) to <code>Box&lt;dyn Any&gt;</code>. <code>Box&lt;dyn Any&gt;</code> can
then be further <code>downcast</code> into <code>Box&lt;ConcreteType&gt;</code> where <code>ConcreteType</code> implements <code>Trait</code>. <a href="#tymethod.into_any">Read more</a></p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.into_any_rc" class="method trait-impl has-srclink"><a href="#method.into_any_rc" class="anchor"></a><h4 class="code-header">pub fn <a class="fnname">into_any_rc</a>(self: <a class="struct" href="https://doc.rust-lang.org/1.60.0/alloc/rc/struct.Rc.html" title="struct alloc::rc::Rc">Rc</a>&lt;T&gt;) -&gt; <a class="struct" href="https://doc.rust-lang.org/1.60.0/alloc/rc/struct.Rc.html" title="struct alloc::rc::Rc">Rc</a>&lt;dyn <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/any/trait.Any.html" title="trait core::any::Any">Any</a> + 'static&gt;</h4></section></summary><div class='docblock'><p>Convert <code>Rc&lt;Trait&gt;</code> (where <code>Trait: Downcast</code>) to <code>Rc&lt;Any&gt;</code>. <code>Rc&lt;Any&gt;</code> can then be
further <code>downcast</code> into <code>Rc&lt;ConcreteType&gt;</code> where <code>ConcreteType</code> implements <code>Trait</code>. <a href="#tymethod.into_any_rc">Read more</a></p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.as_any" class="method trait-impl has-srclink"><a href="#method.as_any" class="anchor"></a><h4 class="code-header">pub fn <a class="fnname">as_any</a>(&amp;self) -&gt; &amp;(dyn <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/any/trait.Any.html" title="trait core::any::Any">Any</a> + 'static)</h4></section></summary><div class='docblock'><p>Convert <code>&amp;Trait</code> (where <code>Trait: Downcast</code>) to <code>&amp;Any</code>. This is needed since Rust cannot
generate <code>&amp;Any</code>s vtable from <code>&amp;Trait</code>s. <a href="#tymethod.as_any">Read more</a></p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.as_any_mut" class="method trait-impl has-srclink"><a href="#method.as_any_mut" class="anchor"></a><h4 class="code-header">pub fn <a class="fnname">as_any_mut</a>(&amp;mut self) -&gt; &amp;mut (dyn <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/any/trait.Any.html" title="trait core::any::Any">Any</a> + 'static)</h4></section></summary><div class='docblock'><p>Convert <code>&amp;mut Trait</code> (where <code>Trait: Downcast</code>) to <code>&amp;Any</code>. This is needed since Rust cannot
generate <code>&amp;mut Any</code>s vtable from <code>&amp;mut Trait</code>s. <a href="#tymethod.as_any_mut">Read more</a></p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-DowncastSync" class="impl has-srclink"><a href="#impl-DowncastSync" class="anchor"></a><h3 class="code-header in-band">impl&lt;T&gt; DowncastSync for T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/any/trait.Any.html" title="trait core::any::Any">Any</a> + <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> + <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a>,&nbsp;</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.into_any_arc" class="method trait-impl has-srclink"><a href="#method.into_any_arc" class="anchor"></a><h4 class="code-header">pub fn <a class="fnname">into_any_arc</a>(self: <a class="struct" href="https://doc.rust-lang.org/1.60.0/alloc/sync/struct.Arc.html" title="struct alloc::sync::Arc">Arc</a>&lt;T&gt;) -&gt; <a class="struct" href="https://doc.rust-lang.org/1.60.0/alloc/sync/struct.Arc.html" title="struct alloc::sync::Arc">Arc</a>&lt;dyn <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/any/trait.Any.html" title="trait core::any::Any">Any</a> + <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/marker/trait.Send.html" title="trait core::marker::Send">Send</a> + <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/marker/trait.Sync.html" title="trait core::marker::Sync">Sync</a> + 'static&gt;</h4></section></summary><div class='docblock'><p>Convert <code>Arc&lt;Trait&gt;</code> (where <code>Trait: Downcast</code>) to <code>Arc&lt;Any&gt;</code>. <code>Arc&lt;Any&gt;</code> can then be
further <code>downcast</code> into <code>Arc&lt;ConcreteType&gt;</code> where <code>ConcreteType</code> implements <code>Trait</code>. <a href="#tymethod.into_any_arc">Read more</a></p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-From%3CT%3E" class="impl has-srclink"><span class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/core/convert/mod.rs.html#553-558">source</a></span><a href="#impl-From%3CT%3E" class="anchor"></a><h3 class="code-header in-band">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.From.html" title="trait core::convert::From">From</a>&lt;T&gt; for T</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.from" class="method trait-impl has-srclink"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/core/convert/mod.rs.html#555">source</a></span><a href="#method.from" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.60.0/core/convert/trait.From.html#tymethod.from" class="fnname">from</a>(t: T) -&gt; T</h4></section></summary><div class="docblock"><p>Returns the argument unchanged.</p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Instrument" class="impl has-srclink"><span class="rightside"><a class="srclink" href="https://docs.rs/tracing/0.1.26/src/tracing/instrument.rs.html#155">source</a></span><a href="#impl-Instrument" class="anchor"></a><h3 class="code-header in-band">impl&lt;T&gt; <a class="trait" href="https://docs.rs/tracing/0.1.26/tracing/instrument/trait.Instrument.html" title="trait tracing::instrument::Instrument">Instrument</a> for T</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.instrument" class="method trait-impl has-srclink"><span class="rightside"><a class="srclink" href="https://docs.rs/tracing/0.1.26/src/tracing/instrument.rs.html#38">source</a></span><a href="#method.instrument" class="anchor"></a><h4 class="code-header">fn <a href="https://docs.rs/tracing/0.1.26/tracing/instrument/trait.Instrument.html#method.instrument" class="fnname">instrument</a>(self, span: <a class="struct" href="https://docs.rs/tracing/0.1.26/tracing/span/struct.Span.html" title="struct tracing::span::Span">Span</a>) -&gt; <a class="struct" href="https://docs.rs/tracing/0.1.26/tracing/instrument/struct.Instrumented.html" title="struct tracing::instrument::Instrumented">Instrumented</a>&lt;Self&gt;</h4></section></summary><div class='docblock'><p>Instruments this type with the provided <code>Span</code>, returning an
<code>Instrumented</code> wrapper. <a href="https://docs.rs/tracing/0.1.26/tracing/instrument/trait.Instrument.html#method.instrument">Read more</a></p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.in_current_span" class="method trait-impl has-srclink"><span class="rightside"><a class="srclink" href="https://docs.rs/tracing/0.1.26/src/tracing/instrument.rs.html#74">source</a></span><a href="#method.in_current_span" class="anchor"></a><h4 class="code-header">fn <a href="https://docs.rs/tracing/0.1.26/tracing/instrument/trait.Instrument.html#method.in_current_span" class="fnname">in_current_span</a>(self) -&gt; <a class="struct" href="https://docs.rs/tracing/0.1.26/tracing/instrument/struct.Instrumented.html" title="struct tracing::instrument::Instrumented">Instrumented</a>&lt;Self&gt;</h4></section></summary><div class='docblock'><p>Instruments this type with the <a href="../struct.Span.html#method.current">current</a> <code>Span</code>, returning an
<code>Instrumented</code> wrapper. <a href="https://docs.rs/tracing/0.1.26/tracing/instrument/trait.Instrument.html#method.in_current_span">Read more</a></p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Into%3CU%3E" class="impl has-srclink"><span class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/core/convert/mod.rs.html#537-548">source</a></span><a href="#impl-Into%3CU%3E" class="anchor"></a><h3 class="code-header in-band">impl&lt;T, U&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;U&gt; for T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;U: <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.From.html" title="trait core::convert::From">From</a>&lt;T&gt;,&nbsp;</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.into" class="method trait-impl has-srclink"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/core/convert/mod.rs.html#545">source</a></span><a href="#method.into" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.60.0/core/convert/trait.Into.html#tymethod.into" class="fnname">into</a>(self) -&gt; U</h4></section></summary><div class="docblock"><p>Calls <code>U::from(self)</code>.</p>
<p>That is, this conversion is whatever the implementation of
<code><a href="https://doc.rust-lang.org/1.60.0/core/convert/trait.From.html" title="From">From</a>&lt;T&gt; for U</code> chooses to do.</p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Same%3CT%3E" class="impl has-srclink"><a href="#impl-Same%3CT%3E" class="anchor"></a><h3 class="code-header in-band">impl&lt;T&gt; Same&lt;T&gt; for T</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Output" class="type trait-impl has-srclink"><a href="#associatedtype.Output" class="anchor"></a><h4 class="code-header">type <a href="#associatedtype.Output" class="associatedtype">Output</a> = T</h4></section></summary><div class='docblock'><p>Should always be <code>Self</code></p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-ToOwned" class="impl has-srclink"><span class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/alloc/borrow.rs.html#84-96">source</a></span><a href="#impl-ToOwned" class="anchor"></a><h3 class="code-header in-band">impl&lt;T&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/alloc/borrow/trait.ToOwned.html" title="trait alloc::borrow::ToOwned">ToOwned</a> for T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/clone/trait.Clone.html" title="trait core::clone::Clone">Clone</a>,&nbsp;</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Owned" class="type trait-impl has-srclink"><a href="#associatedtype.Owned" class="anchor"></a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.60.0/alloc/borrow/trait.ToOwned.html#associatedtype.Owned" class="associatedtype">Owned</a> = T</h4></section></summary><div class='docblock'><p>The resulting type after obtaining ownership.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.to_owned" class="method trait-impl has-srclink"><span class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/alloc/borrow.rs.html#89">source</a></span><a href="#method.to_owned" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.60.0/alloc/borrow/trait.ToOwned.html#tymethod.to_owned" class="fnname">to_owned</a>(&amp;self) -&gt; T</h4></section></summary><div class='docblock'><p>Creates owned data from borrowed data, usually by cloning. <a href="https://doc.rust-lang.org/1.60.0/alloc/borrow/trait.ToOwned.html#tymethod.to_owned">Read more</a></p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.clone_into" class="method trait-impl has-srclink"><span class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/alloc/borrow.rs.html#93">source</a></span><a href="#method.clone_into" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.60.0/alloc/borrow/trait.ToOwned.html#method.clone_into" class="fnname">clone_into</a>(&amp;self, target: <a class="primitive" href="https://doc.rust-lang.org/1.60.0/std/primitive.reference.html">&amp;mut </a>T)</h4></section></summary><div class="item-info"><div class="stab unstable"><span class="emoji">🔬</span> This is a nightly-only experimental API. (<code>toowned_clone_into</code>)</div></div><div class='docblock'><p>Uses borrowed data to replace owned data, usually by cloning. <a href="https://doc.rust-lang.org/1.60.0/alloc/borrow/trait.ToOwned.html#method.clone_into">Read more</a></p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-TryFrom%3CU%3E" class="impl has-srclink"><span class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/core/convert/mod.rs.html#594-603">source</a></span><a href="#impl-TryFrom%3CU%3E" class="anchor"></a><h3 class="code-header in-band">impl&lt;T, U&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;U&gt; for T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;U: <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.Into.html" title="trait core::convert::Into">Into</a>&lt;T&gt;,&nbsp;</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Error" class="type trait-impl has-srclink"><a href="#associatedtype.Error" class="anchor"></a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.60.0/core/convert/trait.TryFrom.html#associatedtype.Error" class="associatedtype">Error</a> = <a class="enum" href="https://doc.rust-lang.org/1.60.0/core/convert/enum.Infallible.html" title="enum core::convert::Infallible">Infallible</a></h4></section></summary><div class='docblock'><p>The type returned in the event of a conversion error.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.try_from" class="method trait-impl has-srclink"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/core/convert/mod.rs.html#600">source</a></span><a href="#method.try_from" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.60.0/core/convert/trait.TryFrom.html#tymethod.try_from" class="fnname">try_from</a>(value: U) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.60.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;T, &lt;T as <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;U&gt;&gt;::<a class="associatedtype" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>&gt;</h4></section></summary><div class='docblock'><p>Performs the conversion.</p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-TryInto%3CU%3E" class="impl has-srclink"><span class="rightside"><a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/core/convert/mod.rs.html#579-588">source</a></span><a href="#impl-TryInto%3CU%3E" class="anchor"></a><h3 class="code-header in-band">impl&lt;T, U&gt; <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.TryInto.html" title="trait core::convert::TryInto">TryInto</a>&lt;U&gt; for T <span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;U: <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;T&gt;,&nbsp;</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Error-1" class="type trait-impl has-srclink"><a href="#associatedtype.Error-1" class="anchor"></a><h4 class="code-header">type <a href="https://doc.rust-lang.org/1.60.0/core/convert/trait.TryInto.html#associatedtype.Error" class="associatedtype">Error</a> = &lt;U as <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;T&gt;&gt;::<a class="associatedtype" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a></h4></section></summary><div class='docblock'><p>The type returned in the event of a conversion error.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.try_into" class="method trait-impl has-srclink"><span class="rightside"><span class="since" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span> · <a class="srclink" href="https://doc.rust-lang.org/1.60.0/src/core/convert/mod.rs.html#585">source</a></span><a href="#method.try_into" class="anchor"></a><h4 class="code-header">pub fn <a href="https://doc.rust-lang.org/1.60.0/core/convert/trait.TryInto.html#tymethod.try_into" class="fnname">try_into</a>(self) -&gt; <a class="enum" href="https://doc.rust-lang.org/1.60.0/core/result/enum.Result.html" title="enum core::result::Result">Result</a>&lt;U, &lt;U as <a class="trait" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.TryFrom.html" title="trait core::convert::TryFrom">TryFrom</a>&lt;T&gt;&gt;::<a class="associatedtype" href="https://doc.rust-lang.org/1.60.0/core/convert/trait.TryFrom.html#associatedtype.Error" title="type core::convert::TryFrom::Error">Error</a>&gt;</h4></section></summary><div class='docblock'><p>Performs the conversion.</p>
</div></details></div></details></div></section><section id="search" class="content hidden"></section></div></main><div id="rustdoc-vars" data-root-path="../../../" data-current-crate="widgetry" data-themes="ayu,dark,light" data-resource-suffix="" data-rustdoc-version="1.60.0 (7737e0b5c 2022-04-04)" ></div>
</body></html>