守听 发表于 2025-1-17 12:46:18

[rustGUI][iced]基于rust的GUI库iced(0.13)的部件学习(04):实现窗口主

前言
本文是关于iced库的部件先容,iced库是基于rust的GUI库,作者自述是受Elm启发。
iced现在的版本是0.13.1,相较于此前的0.12版本,有较大改动。
本合集是基于新版本的关于分部件(widget)的使用先容,包罗源代码先容、实例使用等。
环境配置
系统:window10
平台:visual studio code
语言:rust
库:iced 0.13
扩展库:iced_aw
主题切换

本文来先容一下怎样为iced窗口进行主题切换,注意,本文以颜色变化为示例,附带一些部件的样式切换。
本文在切换时,将使用菜单来进行,所以需要用到菜单部件,但iced源码中并没有给出一个好用的menu部件,但iced的代码堆栈包罗一个iced_aw库,即iced addtional widgets,在iced_aw中,实现了menu部件,我们可以使用。
需要现在toml文件中添加依赖,并启用menu部件的features:
iced_aw={version="0.11.0",features=["menu"]}然后在主程序里导入:
use iced_aw::menu::{self,Item,Menu,MenuBar};
use iced_aw::{pub struct Menu<'a, Message, Theme, Renderer>
where
    Theme: Catalog,
    Renderer: renderer::Renderer,
{
    pub(super) items: Vec<Item<'a, Message, Theme, Renderer>>,
    pub(super) spacing: Pixels,
    pub(super) max_width: f32,
    pub(super) width: Length,
    pub(super) height: Length,
    pub(super) axis: Axis,
    pub(super) offset: f32,
}};1、menu部件的先容

我们结合官方源码,先来先容一下怎样使用menu部件。
从上面的导入中,我们看到,iced_aw中,menu部件有Item、Menu、MenuBar这三个子项,你可以将它们的关系理解为层层递进,即Item是最根本的菜单项,而Menu包罗Item,MenuBar包罗Menu。
简单的理解就是,Item可以是一个个的单个菜单项,好比打开菜单,当然,也可以嵌套菜单,好比Item本身也是一个Menu。
而Menu就是一个个Item聚集在一起的一组菜单,好比文件菜单组。
以此类推,MenuBar就是一组组菜单栏的聚集,好比窗口顶部的菜单栏,包罗文件、工具、选项、关于等等这样的菜单组。
还是通过源码来亲身看一下吧。
Item
官方源码

/// Item inside a [`Menu`]
#
pub struct Item<'a, Message, Theme, Renderer>
where
    Theme: Catalog,
    Renderer: renderer::Renderer,
{
    pub(super) item: Element<'a, Message, Theme, Renderer>,
    pub(super) menu: Option<Box<Menu<'a, Message, Theme, Renderer>>>,
}可以看到MenuBar的参数roots,其类型与Menu的参数items的类型是一样的,这其实很好理解,MenuBar和Menu逻辑上就是一致的,二者都是之菜单的聚集,只是我们通常会将单组菜单与总菜单栏分开创建,所以源码中这个区分也是正常的。
除了上述三个函数外,iced_aw的menu部件还提供了两个宏:
pub struct Menu<'a, Message, Theme, Renderer>
where
    Theme: Catalog,
    Renderer: renderer::Renderer,
{
    pub(super) items: Vec<Item<'a, Message, Theme, Renderer>>,
    pub(super) spacing: Pixels,
    pub(super) max_width: f32,
    pub(super) width: Length,
    pub(super) height: Length,
    pub(super) axis: Axis,
    pub(super) offset: f32,
}这应该很明确,是用于快捷创建MenuBar和Item的。
在iced_aw的官方示例中,提供了4种创建menu的例子,第一种是利用Item和MenuBar来规规矩矩的创建。
第二种方法是利用宏macro来创建。
第三种也是利用宏。
第四种是利用函数结合宏来创建。
我们来使用第一种,仿照官方示例,看一下现实效果,先编写view函数的代码:
/// menu bar
#
pub struct MenuBar<'a, Message, Theme, Renderer>
where
    Theme: Catalog,
    Renderer: renderer::Renderer,
{
    roots: Vec<Item<'a, Message, Theme, Renderer>>,
    spacing: Pixels,
    padding: Padding,
    width: Length,
    height: Length,
    check_bounds_width: f32,
    draw_path: DrawPath,
    scroll_speed: ScrollSpeed,
    class: Theme::Class<'a>,
}运行效果:
https://img2024.cnblogs.com/blog/2558709/202501/2558709-20250110105033547-1364782895.png
看起来是可以的,但是上面我们只是创建了最简单的菜单,没有设置任何样式,也没有添加任何响应,若是想要创建好看的菜单栏,以及添加功能响应,那么还需要增加其他代码。
2、本身封装menu函数

在iced_aw的源代码中,就提供了封装成函数来创建menu的方法,这样当然很好,所以我们也要这样做,由于,你应该也不想在view函数里编写大量的菜单创建条,显得臃肿而且未便于检查。
但我们不想用官方那种方法,所以我们本身封装一个menucreate函数,可以根据需要创建一个菜单组。
以下,我们的实例将这样来实现,我们的函数提供三种菜单样式,即button、纯文本以及slider,可以创建一组,也可以创建单个,且可以设置样式,本例中,我们只设置颜色来演示。
我们从最简单的开始,首先,我们先新建一个menuset.rs文件,在其中编写我们需要的函数。为了简单,我们对于button、text以及slider类型分别编写一个函数,以button为例,我们创建menu_button函数,这个函数将根据传入的content和msg来返回一个Item,其子元素是button。
menu_button
创建单个菜单项
menu_bar,menu_items我们再来修改一下view函数:
let sub1=Item::with_menu(
            button("文件"),
            Menu::new(
                [
                  Item::new("打开"),
                  Item::new("保存"),
                  Item::new("关闭"),
                ].into()
                ).max_width(120.0).spacing(5)
            );
      
      let sub2=Item::with_menu(
            button("选项"),
            Menu::new([
                Item::new("设置参数"),
                Item::new("状态监控"),
                Item::new("数据导入"),
            ].into()
            ).max_width(120.0).spacing(5)
            );
      
      let menubar=MenuBar::new(vec![
            sub1,
            sub2
      ]).width(iced::Length::Fill).spacing(5).padding(10);

      column![
            menubar,
      ]
      .into()相比之下,要简便不少,关键是我们可以直接传入菜单的名称和触发消息,函数会同一生成菜单组,而且,如果想要个别添加如slider、text,可以使用push直接添加。
3、主题切换

本文的目的是使用菜单实现主题(颜色)切换,上面我们实现了菜单的添加,并且本身封装了函数,现在我们能够快速添加菜单组了,我们添加一组新的菜单:
主题:

默认、主题1、主题2、主题3

首先,我们新增一组Message,为了便于管理,我们新建一个enum:
///
/// 创建单个菜单项-button
///
pub fn menu_button<'a>(
    msg:Message,
    content:&'a str
) -> Item<'a,Message,Theme,Renderer>
where
{
    let item=button(text(content).size(15)).on_press(msg);
    Item::new(item)
}创建完成后,在Message中调用以上摆列即可。
接着我们修改view函数,新增一组菜单:
let item_open=menu_button(Message::BtnLoad,"打开");
      let item_save=menu_button(Message::BtnLoad,"保存");
      let item_close=menu_text("关闭");
      let item_new=menu_button(Message::BtnLoad,"新建");
      let item_sl=menu_slider(0.0..=1.0, 0.1,self.sldvalue,Message::Sld1);
      let sub1=Item::with_menu(
            button("文件"),
            Menu::new(
                [
                  item_open,
                  item_save,
                  item_close,
                  item_new,
                  item_sl,
                ].into()
                ).max_width(120.0).spacing(5)
            );
      
      let item_setparam=menu_button(Message::BtnLoad, "设置参数");
      let item_monitor=menu_button(Message::BtnLoad, "状态监控");
      let item_dataimport=menu_button(Message::BtnLoad, "数据导入");
      let sub2=Item::with_menu(
            button("选项"),
            Menu::new([
                item_setparam,
                item_monitor,
                item_dataimport
            ].into()
            ).max_width(120.0).spacing(5)
            );

   
      
      let menubar=MenuBar::new(vec![
            sub1,
            sub2,
      ]).width(iced::Length::Fill).spacing(5).padding(10);

      column![
            menubar,
      ]
      .into()效果演示:
https://img2024.cnblogs.com/blog/2558709/202501/2558709-20250113160018046-1700662177.png
最后,我们需要为菜单实现功能,即当我们点击相应菜单时,整个窗口的主题颜色将会改变。
这需要在update函数中进行修改,同时,为了实现颜色改变,我们需要设置窗口的theme或者style。
需要先修改一下主函数:
///
/// 创建一组菜单
///
pub fn menu_group_add<'a>(
    items:Vec<&'a str>,
    msgs:Vec<Message>,
) -> Vec<Item<'a,Message,Theme,Renderer>>{
    if items.len() != msgs.len() {
      let res=MessageDialog::new()
            .set_title("Error")
            .set_description("items.len() != msgs.len()")
            .show();
      if res == rfd::MessageDialogResult::Yes {
            panic!("items.len() != msgs.len()");
      } else {
            panic!("items.len() != msgs.len()");
      }
      
    } else {
      let mut vec1=Vec::new();
      for (index,i) in items.iter().enumerate(){
            let msg=msgs;
            let btn=button(text(*i).size(15)).on_press(msg);
            let item_temp=Item::new(btn);
            vec1.push(item_temp);
      }
      vec1
    }
      
}设置一下iced::application的theme参数,是一个闭包函数,函数返回的是Theme。
所以,我们需要为Counter新增一个函数:
//菜单组1
      let mut mga1=menu_group_add(
            vec!["打开","关闭","保存"],
      vec![Message::WJ(MenuWJ::Open),
                  Message::WJ(MenuWJ::Close),
                  Message::WJ(MenuWJ::Save)]);
      mga1.push(menu_slider(0.0..=10.0, 0.1, self.sldvalue, Message::Sld1));
      let sub1=menu_group_sub(
            "文件",
            Message::WJ(MenuWJ::Wj),
            mga1);
      
      //菜单组2
      let mut mga2=menu_group_add(
            vec!["设置","调整","导入"],
             vec![Message::XX(MenuXX::Xx),
                  Message::XX(MenuXX::Modify),
                  Message::XX(MenuXX::Import),
             ]);
      mga2.push(menu_text("导出"));
      let sub2=menu_group_sub(
            "选项",
            Message::XX(MenuXX::Xx),
            mga2);
      
      let menubar=MenuBar::new(vec![
            sub1,
            sub2,
      ]).width(iced::Length::Fill).spacing(5).padding(10);

      column![
            menubar,
      ]
      .into()此处self.theme是需要我们新增的变量,用于设置当前窗口的Theme:
#
enum MenuStyle{
    Default,
    Style1,
    Style2,
    Style3,
    Ms,//head
}theme的类型就是iced::Theme。
这样一来,我们就将变量与窗口的主题绑定起来,如果我们要修改窗口主题,只需要修改theme变量的值即可。
所以,我们在updata函数里来更新:
let mga3=menu_group_add(
            vec!["默认","主题1","主题2","主题3"],
            vec![
                Message::STYLE(MenuStyle::Default),
                Message::STYLE(MenuStyle::Style1),
                Message::STYLE(MenuStyle::Style2),
                Message::STYLE(MenuStyle::Style3),
            ]);
      let sub3=menu_group_sub(
            "主题",
            Message::STYLE(MenuStyle::Ms),
            mga3);上面代码中使用的是系统预设的Theme。
效果演示:
https://img2024.cnblogs.com/blog/2558709/202501/2558709-20250113170601493-396982241.png
https://img2024.cnblogs.com/blog/2558709/202501/2558709-20250113170650535-995059734.png
也可以自定义,好比,我们创建一个函数,用于返回一个自定义颜色的Theme:
   iced::application("count",Counter::update,Counter::view)
            .default_font(iced::Font::with_name("微软雅黑"))
            .window(Settings{
                size:iced::Size{
                  width:400.0,
                  height:300.0
                },
                position:Position::Specific(iced::Point{
                  x:100.0,
                  y:100.0
                }),
                icon:Some(myicon),
                ..Default::default()
            })
            .theme(Counter::theme)
            .run()然后修改update函数:
fn theme(&self) -> iced::Theme {
      self.theme.clone()
    }分别传入了四种自定义的颜色值。
最后看一下动态演示:
https://img2024.cnblogs.com/blog/2558709/202501/2558709-20250117125434331-355586381.gif
4、综述

以上,我们在iced中实现了菜单的设置,以及利用菜单来切换主题颜色的功能。当然,功能仍旧是比力简单的,但是本文的目的是先容,我认为已经达到了目的,所以其他相干的,本文就不会赘述。

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
页: [1]
查看完整版本: [rustGUI][iced]基于rust的GUI库iced(0.13)的部件学习(04):实现窗口主