前言
本文是关于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`]
- #[must_use]
- 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
- #[must_use]
- 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>,
- }
复制代码 运行效果:
看起来是可以的,但是上面我们只是创建了最简单的菜单,没有设置任何样式,也没有添加任何响应,若是想要创建好看的菜单栏,以及添加功能响应,那么还需要增加其他代码。
2、本身封装menu函数
在iced_aw的源代码中,就提供了封装成函数来创建menu的方法,这样当然很好,所以我们也要这样做,由于,你应该也不想在view函数里编写大量的菜单创建条,显得臃肿而且未便于检查。
但我们不想用官方那种方法,所以我们本身封装一个menucreate函数,可以根据需要创建一个菜单组。
以下,我们的实例将这样来实现,我们的函数提供三种菜单样式,即button、纯文本以及slider,可以创建一组,也可以创建单个,且可以设置样式,本例中,我们只设置颜色来演示。
我们从最简单的开始,首先,我们先新建一个menuset.rs文件,在其中编写我们需要的函数。为了简单,我们对于button、text以及slider类型分别编写一个函数,以button为例,我们创建menu_button函数,这个函数将根据传入的content和msg来返回一个Item,其子元素是button。
menu_button
创建单个菜单项我们再来修改一下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()
复制代码 效果演示:

最后,我们需要为菜单实现功能,即当我们点击相应菜单时,整个窗口的主题颜色将会改变。
这需要在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[index];
- 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:- #[derive(Debug, Clone,Copy)]
- 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。
效果演示:
也可以自定义,好比,我们创建一个函数,用于返回一个自定义颜色的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()
- }
复制代码 分别传入了四种自定义的颜色值。
最后看一下动态演示:
4、综述
以上,我们在iced中实现了菜单的设置,以及利用菜单来切换主题颜色的功能。当然,功能仍旧是比力简单的,但是本文的目的是先容,我认为已经达到了目的,所以其他相干的,本文就不会赘述。
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。 |