Rust图形界面：从零开始创建eGUi项目

文章目录

egui系列：初步

创建

首先，用cargo创建一个新项目，并添加eframe

cargo new hello
cd hello
cargo add eframe
cargo run

尽管默认创建的项目只实现了输出Hello world功能，但添加了eframe库，所以下载需要一点时间。

创建成功后，直接把下面的代码写入main.rs文件中，这些代码来自egui的hello_world示例。

#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]useeframe::egui;structMyApp{
    name:String,
    age:u32,}implDefaultforMyApp{fndefault()->Self{Self{
            name:"Arthur".to_owned(),
            age:42,}}}impleframe::AppforMyApp{fnupdate(&mutself, ctx:&egui::Context, _frame:&muteframe::Frame){egui::CentralPanel::default().show(ctx,|ui|{
            ui.heading("self-introduction");
            ui.horizontal(|ui|{
                ui.label("name: ");
                ui.text_edit_singleline(&mutself.name);});
            ui.horizontal(|ui|{
                ui.add(egui::Slider::new(&mutself.age,0..=120).text("age"));if ui.button("add one").clicked(){self.age +=1;}});
        ui.label(format!("I'm {}, {} years old",self.name,self.age));});}}fnmain()->Result<(),eframe::Error>{let options =eframe::NativeOptions{
        initial_window_size:Some(egui::vec2(320.0,160.0)),..Default::default()};eframe::run_native("self introduce",
        options,Box::new(|_cc|Box::<MyApp>::default()),)}

然后运行cargo run，结果如下所示

组件

在eGUI初体验中，对其整体框架进行了说明，也大致讲解了每行语句的作用，但并没有十分确切地介绍eGUI中提供的函数的具体用法。

在这个小程序中，总共用到了5种控件，即下面5种

• ui.heading 大文字
• ui.label 标签
• ui.text_edit_singleline 单行可编辑文本
• ui.button 按钮
• Slider 滚动条

主要来自两个结构体，分别是Ui和Widget。其中Ui里的组件以函数形式调用，Widget中的组件以结构体的形式调用。但大部分组件，二者之间可以互相转换。例如，在上面的代码中，通过调用

ui.label("name: ");

来创造一个标签，但也可以用另一种方法

ui.add(egui::Label::new("name: "));

但相比之下，直接用ui.label显然更加简洁。但是Slider并没有提供类似的简便的函数，所以只能用

egui::Slider::new

的方式创建。

show函数

eframe::App中，先是一层update函数，然后则是一层show函数，除了self之外，show有两个输入参数，分别是

• ctx: &Context,
• add_contents: impl FnOnce(&mut Ui) -> R

其中add_contents也是一个函数，换言之，show起到了一个回调函数的作用，其逻辑是，传给show一个ui参数，然后再add_contents中对ui进行设置，所以在添加组件时，要么直接调用ui.XXX，就算直接定义egui中的组件，也需要用ui.add将其添入其中。