#relm #widgets #events #update #generation #gui #msg

relm-derive-common

relm包内部使用的通用衍生实现

13个不稳定版本 (6个重大更改)

使用旧的Rust 2015

0.16.0 2019年4月14日
0.15.3 2019年3月25日
0.15.2 2019年1月15日
0.15.0 2018年9月12日
0.11.0 2017年11月26日

#540 in 过程宏

Download history 66/week @ 2024-03-16 55/week @ 2024-03-23 169/week @ 2024-03-30 55/week @ 2024-04-06 61/week @ 2024-04-13 68/week @ 2024-04-20 57/week @ 2024-04-27 45/week @ 2024-05-04 65/week @ 2024-05-11 63/week @ 2024-05-18 99/week @ 2024-05-25 92/week @ 2024-06-01 34/week @ 2024-06-08 62/week @ 2024-06-15 42/week @ 2024-06-22 7/week @ 2024-06-29

每月下载量159
用于 4 个包(通过 relm-derive-state

MIT 许可证

110KB
2.5K SLoC

Relm

异步、基于GTK+的GUI库,受Elm启发,用Rust编写。

此库处于测试阶段:它尚未经过彻底测试,其API可能随时更改。

link link link link link link link link

要求

由于relm基于GTK+,您需要此库才能使用它。

有关安装GTK+的信息,请参阅此页面

使用方法

首先,将以下内容添加到您的Cargo.toml

[source,toml]

gtk = "^0.16.0"
relm = "^0.24.0"
relm-derive = "^0.24.0"

然后,将以下内容添加到您的包中

[source,rust]

use relm::{connect, Relm, Update, Widget};
use gtk::prelude::*;
use gtk::{Window, Inhibit, WindowType};
use relm_derive::Msg;

然后,创建您的模型

[source,rust]

struct Model {
    //
}

模型包含与Widget相关的数据。它可能由Widget::update函数更新。

创建您的消息enum

[source,rust]

#[derive(Msg)]
enum Msg {
    //
    Quit,
}

消息被发送到Widget::update,以指示发生了事件。在接收到事件时,模型可以更新。

创建一个struct,它表示包含GTK+小部件(在本例中为应用程序的主窗口)和模型的Widget

[source,rust]

struct Win {
    //
    model: Model,
    window: Window,
}

为了使此struct成为库可以显示的relm Widget,实现UpdateWidget特性

[source,rust]

impl Update for Win {
    // Specify the model used for this widget.
    type Model = Model;
    // Specify the model parameter used to init the model.
    type ModelParam = ();
    // Specify the type of the messages sent to the update function.
    type Msg = Msg;

    // Return the initial model.
    fn model(_: &Relm<Self>, _: ()) -> Model {
        Model {
        }
    }

    // The model may be updated when a message is received.
    // Widgets may also be updated in this function.
    fn update(&mut self, event: Msg) {
        match event {
            Msg::Quit => gtk::main_quit(),
        }
    }
}

impl Widget for Win {
    // Specify the type of the root widget.
    type Root = Window;

    // Return the root widget.
    fn root(&self) -> Self::Root {
        self.window.clone()
    }

    // Create the widgets.
    fn view(relm: &Relm<Self>, model: Self::Model) -> Self {
        // GTK+ widgets are used normally within a `Widget`.
        let window = Window::new(WindowType::Toplevel);

        // Connect the signal `delete_event` to send the `Quit` message.
        connect!(relm, window, connect_delete_event(_, _), return (Some(Msg::Quit), Inhibit(false)));
        // There is also a `connect!()` macro for GTK+ events that do not need a
        // value to be returned in the callback.

        window.show_all();

        Win {
            model,
            window,
        }
    }
}

最后,通过调用Win::run()来显示此Widget

[source,rust]

fn main() {
    Win::run(()).unwrap();
}

#[widget] 属性

提供一个 #[widget] 属性以简化小部件的创建。

此属性执行以下操作:

  • 提供一个 view! 宏,以声明性语法创建小部件。
  • 自动创建 fn root()type Msgtype Modeltype ModelParamtype Root 项目。
  • 当将属性分配给模型时,自动在 update() 函数中插入对 Widget::set_property() 的调用。
  • 自动创建 Widget struct
  • UpdateWidget 特性可以同时实现。

要使用此属性,请添加以下代码:

[source,rust]

use relm_derive::widget;

以下是如何使用此属性的示例:

[source,rust]

#[derive(Msg)]
pub enum Msg {
    Decrement,
    Increment,
    Quit,
}

pub struct Model {
    counter: u32,
}

#[widget]
impl Widget for Win {
    fn model() -> Model {
        Model {
            counter: 0,
        }
    }

    fn update(&mut self, event: Msg) {
        match event {
            // A call to self.label1.set_text() is automatically inserted by the
            // attribute every time the model.counter attribute is updated.
            Msg::Decrement => self.model.counter -= 1,
            Msg::Increment => self.model.counter += 1,
            Msg::Quit => gtk::main_quit(),
        }
    }

    view! {
        gtk::Window {
            gtk::Box {
                orientation: Vertical,
                gtk::Button {
                    // By default, an event with one paramater is assumed.
                    clicked => Msg::Increment,
                    // Hence, the previous line is equivalent to:
                    // clicked(_) => Increment,
                    label: "+",
                },
                gtk::Label {
                    // Bind the text property of this Label to the counter attribute
                    // of the model.
                    // Every time the counter attribute is updated, the text property
                    // will be updated too.
                    text: &self.model.counter.to_string(),
                },
                gtk::Button {
                    clicked => Msg::Decrement,
                    label: "-",
                },
            },
            // Use a tuple when you want to both send a message and return a value to
            // the GTK+ callback.
            delete_event(_, _) => (Msg::Quit, Inhibit(false)),
        }
    }
}

注意:由于属性的原因,现在自动创建了 struct Win、函数 root() 以及相关的类型 ModelModelParamMsgContainer。如果需要,您仍然可以提供方法和相关类型,但不能创建 struct

警告:由于 #[widget] 使得生成的 struct 是公开的,因此相应的模型和消息类型也必须是公开的。

[警告]

使用此属性时,由于代码生成简单,程序可能会变慢。例如,以下代码 [source,rust]

fn update(&mut self, event: Msg) {
    for _ in 0..100 {
        self.model.counter += 1;
    }
}

将生成此函数:[source,rust]

fn update(&mut self, event: Msg) {
    for _ in 0..100 {
        self.model.counter += 1;
        self.label1.set_text(&self.model.counter.to_string());
    }
}

[警告]

此外,目前仅在将属性分配给模型时插入 set_property() 调用。例如,以下代码 [source,rust]

fn update(&mut self, event: Msg) {
    self.model.text.push_str("Text");
}

将不会按预期工作。

如果需要,请使用以下变体 [source,rust]

fn update(&mut self, event: Msg) {
    self.model.text += "Text";
}

有关如何使用 relm 的更多信息,您可以查看 示例

捐赠

如果您喜欢此项目并希望实施新功能,请在我在 Patreon 上的页面上支持我。

link

使用 relm 的项目

  • Yellow Pitaya:红皮塔亚硬件示波器的桌面界面。
  • Game of Life:康威生命游戏模拟器
  • Country Parser:解析 Google 位置历史并显示访问过的国家的时间线
  • Chessground:一个实验性的棋盘小部件
  • Effitask:基于todo.txt格式的图形任务管理器
  • KS Curve Tracer:AD2曲线追踪器的配套应用程序
  • Cigale:准备您在工作时完成的任务的工时表的工具
  • Projectpad:作为软件开发人员或系统管理员,管理秘密凭据和服务器信息。
  • TimezoneRS:一个图形应用程序,可以直观地看到不同时区的时间
  • Tubefeeder / Pipeline:在一个地方观看YouTube、LBRY和PeerTube视频。
  • Hotwire:以简单的方式研究几个流行协议的网络流量
  • gue:控制飞利浦Hue灯的GUI
  • MyCitadel钱包:MyCitadel加密货币钱包应用程序

如果您想将您的项目添加到这个列表中,请创建一个拉取请求

依赖项

~2MB
~46K SLoC