pub struct Canvas { /* private fields */ }Expand description
A box a config draws on with paths, arcs, curves and dashed strokes, for progress rings, graphs and audio visualizers.
The paint closure gets a Pen and runs when the canvas is first
laid out, when its laid-out size changes, and when a signal it read
changes; each run replaces the drawing, and repaints only the
canvas’s box. Coordinates are logical pixels from the canvas’s
top-left, and the drawing is cut to its box and rounded corners. Size
it with its style’s width and height, or let its parent stretch
it, as any box. A panic in the closure is logged with the canvas’s
path, such as PanelWindow[DP-1]/Row/Canvas[2].paint, and the last
drawing stays.
use crabshell_ui::{Canvas, Cap, Color, Path, Point, Stroke, Style};
let charge = cx.signal(0.6_f32);
let ring = Canvas::new(move |pen| {
let size = pen.size();
let middle = Point::new(size.width / 2.0, size.height / 2.0);
let radius = size.width.min(size.height) / 2.0 - 3.0;
let arc = Path::new().arc(middle, radius, -90.0, 360.0 * charge.get());
pen.stroke(&arc, &Stroke::new(4.0, Color::hex("#a6e3a1")).cap(Cap::Round));
})
.style(Style::new().width(24.0).height(24.0));Implementations§
Source§impl Canvas
impl Canvas
Sourcepub fn style(self, style: impl IntoProp<Style>) -> Canvas
pub fn style(self, style: impl IntoProp<Style>) -> Canvas
Sets the style: its width and height size the canvas, and its
background and border are drawn under the drawing.
Sourcepub fn visible(self, visible: impl IntoProp<bool>) -> Self
pub fn visible(self, visible: impl IntoProp<bool>) -> Self
Shows or hides the widget. Hidden, it is taken out of the layout, so its space goes to the others, and it isn’t drawn, hit or reached by Tab; it drops the keyboard focus and the pointer. Its bindings and state stay, so it shows again as it was. Shown by default.
Sourcepub fn geometry(self, geometry: Signal<Rect>) -> Self
pub fn geometry(self, geometry: Signal<Rect>) -> Self
Shares where the widget is: after each layout that moves or
resizes it, its laid-out rectangle in the window’s logical
pixels, scrolled with any scroll view around it but not moved by
a style’s translate, scale or rotate, is written to geometry. A
hidden widget writes nothing. An effect that reads it may change
the layout: the window is laid out again at once, until nothing
moves.
Sourcepub fn mapped_geometry(self, geometry: Signal<Rect>) -> Self
pub fn mapped_geometry(self, geometry: Signal<Rect>) -> Self
Shares where the widget is drawn: the box around it once its own and its ancestors’ translate, scale and rotate have moved it, in the window’s logical pixels, scrolled with any scroll view around it. It is written after each layout that moves it and after each change of a transform or an offset that does, every frame of an animated one. A hidden widget writes nothing. Where the window itself is on its output is unknown: Wayland doesn’t tell a client.
Sourcepub fn accessible_name(self, name: impl IntoProp<String>) -> Self
pub fn accessible_name(self, name: impl IntoProp<String>) -> Self
What a screen reader calls the widget, instead of what it shows: a button’s text, a text’s own, or a field’s placeholder. An icon button needs one to be read at all.