rstk 0.3.0

A Rust binding for the Tk graphics toolkit. Tk is suitable for creating simple GUI programs or interactive graphical displays. This library supports a large portion of the Tk API, in a generally rust-like style.
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

//! Label-frame widget - a container widget for other widgets; like frames 
//! but with an optional text label.
//!
//! * also see the Tk [manual](https://www.tcl-lang.org/man/tcl8.6/TkCmd/ttk_labelframe.htm)

use super::grid;
use super::pack;
use super::widget;
use super::wish;

/// Refers to a label-frame widget
#[derive(Clone)]
pub struct TkLabelFrame {
    pub id: String,
}

/// Creates an instance of a label-frame widget in given parent.
pub fn make_label_frame(parent: &impl widget::TkWidget) -> TkLabelFrame {
    let id = wish::next_wid(parent.id());
    let msg = format!("ttk::labelframe {}", id);
    wish::tell_wish(&msg);

    TkLabelFrame { id }
}

impl widget::TkWidget for TkLabelFrame {
    /// Returns the widget's id reference - used within tk
    fn id(&self) -> &str {
        &self.id
    }
}
impl grid::TkGridLayout for TkLabelFrame {}
impl pack::TkPackLayout for TkLabelFrame {}

impl TkLabelFrame {
    /// Size of border around frame
    pub fn border_width(&self, width: u64) {
        widget::configure(&self.id, "borderwidth", &width.to_string());
    }

    /// Height of frame, in rows
    pub fn height(&self, height: u64) {
        widget::configure(&self.id, "height", &height.to_string());
    }

    /// Position of frame label around the frame.
    ///
    /// Note: `Anchor::Centre` is ignored.
    ///
    pub fn label_anchor(&self, value: widget::Anchor) {
        let value = match value {
            widget::Anchor::N => "n",
            widget::Anchor::NE => "ne",
            widget::Anchor::E => "e",
            widget::Anchor::SE => "se",
            widget::Anchor::S => "s",
            widget::Anchor::SW => "sw",
            widget::Anchor::W => "w",
            widget::Anchor::NW => "nw",
            widget::Anchor::Center | widget::Anchor::Centre => "center",
        };
        if value != "center" {
            // ignore centre
            widget::configure(&self.id, "anchor", value);
        }
    }

    /// Padding to place around the frame. Takes
    /// an array of up to four values, specifying:
    ///
    /// * \[all]
    /// * [left-right top-bottom]
    /// * [left top-bottom right]
    /// * [left top right bottom]
    pub fn padding(&self, values: &[u64]) {
        widget::padding(&self.id, values);
    }

    /// Style of border around frame
    pub fn relief(&self, value: widget::Relief) {
        widget::configure(&self.id, "relief", &value.to_string());
    }

    /// Sets the state of the button (normal or disabled).
    pub fn state(&self, value: widget::State) {
        widget::configure(&self.id, "state", &value.to_string());
    }

    /// Sets the text label for the widget.
    pub fn text(&self, value: &str) {
        widget::configure(&self.id, "text", value);
    }

    /// Underlines the character at the given index position.
    pub fn underline(&self, index: u64) {
        widget::configure(&self.id, "underline", &index.to_string());
    }

    /// Width of frame, in columns
    pub fn width(&self, width: u64) {
        widget::configure(&self.id, "width", &width.to_string());
    }
}