haussmann 0.0.3

Integrate highly customisable widgets and themes for any Rust application or GUI library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

// This file is part of "haussmann"
// Under the MIT License
// Copyright (c) 2023 Antonin Hérault

use crate::{
    graphics::{
        colours::{self, RGBA},
        shapes, Shape, Size,
    },
    Border, DebugWidget, ToAny, Widget,
};

/// Fixed zone containing a widget which is not able to go beyond it and which
/// will be of size `self.size`.
#[derive(Debug)]
pub struct Container {
    /// The size of the zone.
    pub size: Size,
    /// The colour of the container.
    pub colour: RGBA,
    /// Borders of the container.
    pub borders: Option<[Border; 4]>,
    /// The widget contained in this fixed zone.
    pub widget: Box<dyn Widget>,
}

crate::dynamic_widget!(Container);

impl Widget for Container {
    /// Returns a rectangle of size `self.size` filled with colour
    /// `self.colour`, with borders if defined.
    fn shape(&self, size: Option<Size>) -> Shape {
        assert_eq!(size, None);

        shapes::Builder::new()
            .rectangle(self.size, self.borders)
            .fill(self.colour)
            .finish()
    }
}

impl Container {
    /// Creates a new containers.
    pub fn new<T: Widget + 'static>(
        size: Size,
        colour: RGBA,
        borders: [Border; 4],
        widget: T,
    ) -> Self {
        Self {
            size,
            colour,
            borders: Some(borders),
            widget: Box::new(widget),
        }
    }

    /// Creates the simple container possible.
    pub fn simple<T: Widget + 'static>(size: Size, widget: T) -> Self {
        Self {
            size,
            colour: colours::TRANSPARENT,
            borders: None,
            widget: Box::new(widget),
        }
    }

    /// Creates a container with a defined colour.
    pub fn coloured<T: Widget + 'static>(size: Size, colour: RGBA, widget: T) -> Self {
        Self {
            size,
            colour,
            borders: None,
            widget: Box::new(widget),
        }
    }

    /// Creates a container with borders.
    pub fn bordered<T: Widget + 'static>(size: Size, borders: [Border; 4], widget: T) -> Self {
        Self {
            size,
            colour: RGBA::default(),
            borders: Some(borders),
            widget: Box::new(widget),
        }
    }
}