《QT实用小工具·三十八》QT炫酷的菜单控件

2024-04-24 04:12

本文主要是介绍《QT实用小工具·三十八》QT炫酷的菜单控件,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

1、概述
源码放在文章末尾

非常飘逸的 Qt 菜单控件,带有各种动画效果,用起来也十分方便。
无限层级,响应键盘、鼠标单独操作,支持单快捷键。
允许添加自定义 widget、layout,当做特殊的 QDialog 使用。

项目demo演示如下:
在这里插入图片描述

项目解析:
放入源代码 将 facile_menu 文件夹放入 Qt 程序,pro 文件的 INCLUDEPATH 加上对应路径,resources 里的资源文件 sub_menu_arrow.png (子菜单箭头)也导入,前缀别名为::/icons/sub_menu_arrow(或按需修改)

包含头文件 #include “facile_menu.h”

创建并显示菜单

// 创建菜单
FacileMenu* menu = new FacileMenu(this);// 添加动作
menu->addAction(QIcon(":/icons/run"), "开始播放 (&S)", [=]{/* 某操作 */
})->tip("Ctrl+S")->disable()->hide();// 显示菜单
menu->execute(QCursor::pos());

常用操作:
连续设置

menu->addAction(QIcon(":/icons/run"), "开始播放 (&S)", [=]{})->tip("Ctrl+S")->disable(playing/*如果满足某条件(默认true)则disable,不满足跳过,下同*/)->hide(/*条件表达式*/)->uncheck(false);

子菜单

auto subMenu = menu->addMenu("子菜单2");subMenu->addAction("继续", [=]{});subMenu3->addAction("停止", [=]{})->disable(!playing);

横向菜单
方式一:

menu->addRow([=]{menu->addAction("按钮1");menu->addAction("按钮2");menu->addAction("按钮3");
});

方式二:

menu->beginRow();
menu->addAction(QIcon(":/icons/run"));
menu->addAction(QIcon(":/icons/pause"));
menu->split();
menu->addAction(QIcon(":/icons/resume"));
menu->addAction(QIcon(":/icons/stop"))->disable();
menu->endRow();

两种方式都支持横向布局 widget

添加标题

menu->addTitle("标题", -1/0/1);

一个灰色文字的 QLabel,根据参数二会选择性添加一条分割线。

-1 添加到标题上方(margin=4),0 不添加分割线,1 添加到标题下方。默认为 0,不带分割线。

添加 QAction
支持在菜单关闭时自动 delete 传入的 action,避免内存泄漏(默认关闭)

QAction* action = ...;
menu->addAction(action, true/*是否在菜单关闭时一起delete*/);

添加 Widget/Layout
添加任意 widget 至菜单中,和菜单项并存,不占 at(index)/indexOf(item) 的位置。layout 同理。

QPushButton* button = new QPushButton("外部添加的按钮", this);
menu->addWidget(button);

添加单选菜单
如果要设置为checkable,请在创建时调用一次其以下任一方法:

setCheckable(bool) / setChecked(bool) / check(bool) / uncheck(bool)

// 使用 linger() 使菜单点击后不隐藏,持续显示当前单选/多选结果
auto ac1 = subMenu2->addAction(QIcon(":/icons/run"), "带图标")->check()->linger();
auto ac2 = subMenu2->addAction("无图标")->uncheck()->linger();
auto ac3 = subMenu2->split()->addAction("全不选")->uncheck()->linger();// 连接点击事件
ac1->triggered([=]{subMenu2->singleCheck(ac1); // 用于单选,表示只选中ac1// 这里可以用于处理其他操作
});
ac2->triggered([=]{subMenu2->singleCheck(ac2);
});
ac3->triggered([=]{subMenu2->uncheckAll(); // 全不选
});

添加多选菜单

// 假装是某一个需要多选的属性
QList<QString>* list = new QList<QString>();for (int i = 0; i < 10; i++)
{auto action = subMenu5->addAction("选项"+QString::number(i))->uncheck()->linger()->autoToggle()/*点击自动切换选中状态*/;action->triggered([=]{// 自己的处理流程,例如调用某个外部的方法if (action->isChecked())list->append(action->getText());elselist->removeOne(action->getText());qDebug() << "当前选中的有:" << *list;});
}

快速批量单选项

QStringList texts;
for (int i = 0; i < 10; i++)texts << "项目"+QString::number(i);
static int selected = 2;menu->addOptions(texts, selected, [=](int index){qDebug() << "选中了:" << (selected = index) << texts.at(index);
});

快速批量多选项
监听每一项改变的结果

// 假装是某一个需要多选的属性
QList<int>* list = new QList<int>();
subMenu6->addNumberedActions("选项%1", 0, 10)->setMultiCheck([=](int index, bool checked){if (checked)list->append(index);elselist->removeOne(index);qDebug() << "当前选中的有:" << *list;});

极简批量多选项
直接读取多选项结果,而不是监听多选项每一项(也可以两者结合)

在finished()中获取checkedItems(),即为选中项

QList<QString>* list = new QList<QString>();
subMenu7->addNumberedActions("选项%1", 0, 15)->setMultiCheck()->finished([=]{*list = subMenu7->checkedItemTexts();qDebug() << "最终选中:" << *list;});

菜单项 API
addAction()后,可直接设置菜单项的一些属性,包括以下:

第一个参数为bool类型的,表示满足此条件才修改设置,例如:

bool needHide = false;
action->hide(needHide); // 不满足隐藏条件,即无视此语句
// 菜单项右边快捷键区域的文字
// 如果要使用,建议用:setTipArea 来额外添加设置右边空白宽度
FacileMenuItem* tip(QString sc);
FacileMenuItem* tip(bool exp, QString sc);// 鼠标悬浮提示
FacileMenuItem* tooltip(QString tt);
FacileMenuItem* tooltip(bool exp, QString tt);// 触发(单击、回车键)后,参数为 Lambda 表达式
FacileMenuItem* triggered(FuncType func);
FacileMenuItem* triggered(bool exp, FuncType func);// 当参数表达式为true时生效,false时忽略,下同
FacileMenuItem* disable(bool exp = true);
FacileMenuItem* enable(bool exp = true);FacileMenuItem* hide(bool exp = true);
FacileMenuItem* visible(bool exp = true);FacileMenuItem* check(bool exp = true);
FacileMenuItem* uncheck(bool exp = true);
FacileMenuItem* toggle(bool exp = true);// 设置data,一般用于单选、多选
FacileMenuItem* setData(QVariant data);
QVariant getData();FacileMenuItem* text(bool exp, QString str);
// 当表达式为true时,设置为tru文字,否则设置为fal文字
FacileMenuItem* text(bool exp, QString tru, QString fal);FacileMenuItem* fgColor(QColor color);
FacileMenuItem* fgColor(bool exp, QColor color);FacileMenuItem* bgColor(QColor color);
FacileMenuItem* bgColor(bool exp, QColor color);// 插入前缀
FacileMenuItem* prefix(bool exp, QString pfix);
FacileMenuItem* prefix(QString pfix);// 插入后缀,参数3支持类似 "action后缀 (K)" 这样的格式
FacileMenuItem* suffix(bool exp, QString sfix, bool inLeftParenthesis = true);
FacileMenuItem* suffix(QString sfix, bool inLeftParenthesis = true);FacileMenuItem* icon(bool ic, QIcon icon);// 设置边界:半径、颜色
FacileMenuItem* borderR(int radius = 3, QColor co = Qt::transparent);// 点击后是否保持菜单显示(默认点一下就隐藏菜单)
FacileMenuItem* linger();
// 点击后保持显示(同linger()),并且修改菜单项文本
FacileMenuItem* lingerText(QString textAfterClick);// 点击后的菜单文本改变
textAfterClick(QString newText);
// 根据当前文本修改为新文本的 Lambda 表达式
// 参数示例:[=](QString s) -> QString { if (s == "xx") return "xx"; }
textAfterClick(FuncStringStringType func);// 满足 exp 时执行 trueLambda 表达式,否则执行 falseLambda 表达式
FacileMenuItem* ifer(bool exp, trueLambda, falseLambda = nullptr);// 逻辑控制
FacileMenuItem* ifer(bool exp); // 满足条件时才继续,下同
FacileMenuItem* elifer(bool exp);
FacileMenuItem* elser();FacileMenuItem* switcher(int value);
FacileMenuItem* caser(int value, matchedLambda); // 匹配时执行Lambda,无需break
FacileMenuItem* caser(int value); // 结束记得breaker(允许忘掉~)
FacileMenuItem* breaker();
FacileMenuItem* defaulter();// 取消后面所有命令(无视层级,相当于函数中return)
FacileMenuItem* exiter(bool ex = true);

注意:由于加了一些容错处理(例如caser可以不用写breaker),无法进行if/switch的多层嵌套(较多的逻辑运算不建议放在菜单中)

配置项
静态统一颜色
都是静态变量,设置一次,所有菜单都生效。

FacileMenu::normal_bg = QColor(255, 255, 255);
FacileMenu::hover_bg = QColor(128, 128, 128, 64);
FacileMenu::press_bg = QColor(128, 128, 128, 128);
FacileMenu::text_fg = QColor(0, 0, 0);
FacileMenu::blur_bg_alpha = DEFAULT_MENU_BLUR_ALPHA;

单个菜单设置
一些可选的设置项,按需加上去,也可以都不加。

FacileMenu* menu = (new FacileMenu(this))->setTipArea("Ctrl+Alt+P") // 设置右边的快捷键提示区域的留空宽度,建议使用最长快捷键->setSplitInRow(true) // 横向按钮是否使用分割线分隔->setSubMenuShowOnCursor(false) // 设置子菜单是从鼠标位置出现还是右边出现->setAppearAnimation(false) // 菜单出现动画->setDisappearAnimation(false); // 菜单消失动画

如果多级菜单中要将这些设置项传递给子菜单。

其中仅 setTipArea 不会传递给下一级。

可以直接修改源码中这些变量的默认值,全部菜单生效。

菜单栏
在这里插入图片描述
结合 FacileMenu 自定义的一个菜单栏,目前不是很完善(做着玩的,但是对这个动画效果确实挺失望的)。

具体可参考 MainWindow 中的写法:

ui->menuBar->setAnimationEnabled(false); // 开启动画
ui->menuBar->addMenu("文件", fileMenu);
ui->menuBar->addMenu("编辑", editMenu);
ui->menuBar->addMenu("查看", viewMenu);
ui->menuBar->addMenu("帮助", helpMenu);
ui->menuBar->insertMenu(2, "格式", formatMenu);

注意点
打开模态对话框可能会引起崩溃
需要在打开模态对话框之前,关闭当前 menu

menu->addAction("选择文件", [=]{menu->close(); // 需要这句,否则会导致崩溃QString path = QFileDialog::getOpenFileName(this, "选择文件", prevPath);// ...
});

菜单关闭导致退出程序
在 main.cpp 中添加以下代码,使窗口关闭后不会退出整个程序:

QApplication a(argc, argv);
a.setQuitOnLastWindowClosed(false);

源码下载

这篇关于《QT实用小工具·三十八》QT炫酷的菜单控件的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/930724

相关文章

Java数字转换工具类NumberUtil的使用

《Java数字转换工具类NumberUtil的使用》NumberUtil是一个功能强大的Java工具类,用于处理数字的各种操作,包括数值运算、格式化、随机数生成和数值判断,下面就来介绍一下Number... 目录一、NumberUtil类概述二、主要功能介绍1. 数值运算2. 格式化3. 数值判断4. 随机

使用Navicat工具比对两个数据库所有表结构的差异案例详解

《使用Navicat工具比对两个数据库所有表结构的差异案例详解》:本文主要介绍如何使用Navicat工具对比两个数据库test_old和test_new,并生成相应的DDLSQL语句,以便将te... 目录概要案例一、如图两个数据库test_old和test_new进行比较:二、开始比较总结概要公司存在多

Java中基于注解的代码生成工具MapStruct映射使用详解

《Java中基于注解的代码生成工具MapStruct映射使用详解》MapStruct作为一个基于注解的代码生成工具,为我们提供了一种更加优雅、高效的解决方案,本文主要为大家介绍了它的具体使用,感兴趣... 目录介绍优缺点优点缺点核心注解及详细使用语法说明@Mapper@Mapping@Mappings@Co

使用Python实现图片和base64转换工具

《使用Python实现图片和base64转换工具》这篇文章主要为大家详细介绍了如何使用Python中的base64模块编写一个工具,可以实现图片和Base64编码之间的转换,感兴趣的小伙伴可以了解下... 简介使用python的base64模块来实现图片和Base64编码之间的转换。可以将图片转换为Bas

使用Java实现一个解析CURL脚本小工具

《使用Java实现一个解析CURL脚本小工具》文章介绍了如何使用Java实现一个解析CURL脚本的工具,该工具可以将CURL脚本中的Header解析为KVMap结构,获取URL路径、请求类型,解析UR... 目录使用示例实现原理具体实现CurlParserUtilCurlEntityICurlHandler

Rsnapshot怎么用? 基于Rsync的强大Linux备份工具使用指南

《Rsnapshot怎么用?基于Rsync的强大Linux备份工具使用指南》Rsnapshot不仅可以备份本地文件,还能通过SSH备份远程文件,接下来详细介绍如何安装、配置和使用Rsnaps... Rsnapshot 是一款开源的文件系统快照工具。它结合了 Rsync 和 SSH 的能力,可以帮助你在 li

基于Go语言实现一个压测工具

《基于Go语言实现一个压测工具》这篇文章主要为大家详细介绍了基于Go语言实现一个简单的压测工具,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录整体架构通用数据处理模块Http请求响应数据处理Curl参数解析处理客户端模块Http客户端处理Grpc客户端处理Websocket客户端

java图像识别工具类(ImageRecognitionUtils)使用实例详解

《java图像识别工具类(ImageRecognitionUtils)使用实例详解》:本文主要介绍如何在Java中使用OpenCV进行图像识别,包括图像加载、预处理、分类、人脸检测和特征提取等步骤... 目录前言1. 图像识别的背景与作用2. 设计目标3. 项目依赖4. 设计与实现 ImageRecogni

基于Python开发电脑定时关机工具

《基于Python开发电脑定时关机工具》这篇文章主要为大家详细介绍了如何基于Python开发一个电脑定时关机工具,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1. 简介2. 运行效果3. 相关源码1. 简介这个程序就像一个“忠实的管家”,帮你按时关掉电脑,而且全程不需要你多做

C#实现WinForm控件焦点的获取与失去

《C#实现WinForm控件焦点的获取与失去》在一个数据输入表单中,当用户从一个文本框切换到另一个文本框时,需要准确地判断焦点的转移,以便进行数据验证、提示信息显示等操作,本文将探讨Winform控件... 目录前言获取焦点改变TabIndex属性值调用Focus方法失去焦点总结最后前言在一个数据输入表单