Qt控件：点击控件

已于 2025-05-22 16:23:28 修改
阅读量506 收藏 5
点赞数 3
分类专栏： # Qt 文章标签： qt 开发语言
于 2025-05-16 15:13:27 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qingttqing/article/details/148007303
版权

交互控件

1. QAction

1. 1简介与API

QAction 是一个核心类，用于表示应用程序中的一个操作（如菜单项、工具栏按钮或快捷键触发的功能）。它将操作的逻辑与 UI 表现分离，使代码更易于维护和扩展。

核心功能

  1. 统一操作逻辑：一个 QAction 可同时关联到菜单、工具栏和快捷键，避免代码重复。
  2. 状态管理：支持启用 / 禁用、选中 / 未选中（如复选框菜单项）等状态。
  3. 图标与文本：可设置图标、文本、工具提示等 UI 属性。
  4. 信号与槽：通过 triggered() 信号触发操作。

API

常用构造函数

QAction(const QString &text, QObject *parent = nullptr);
QAction(const QIcon &icon, const QString &text, QObject *parent = nullptr);

设置属性

setText(const QString &text)：设置显示文本。
setIcon(const QIcon &icon)：设置图标。
setToolTip(const QString &tip)：设置工具提示。
setShortcut(const QKeySequence &shortcut)：设置快捷键。
setCheckable(bool checkable)：设置是否可勾选（如复选框菜单项）。
setChecked(bool checked)：设置勾选状态。
setEnabled(bool enabled)：启用 / 禁用操作。

获取属性

text()：获取显示文本。
icon()：获取图标。
shortcut()：获取快捷键。
isChecked()：判断是否被勾选。
isEnabled()：判断是否启用。

信号

triggered(bool checked = false)：操作被触发时发出（如点击菜单项）。
toggled(bool checked)：状态切换时发出（仅在 checkable 为 true 时）。

1.2 实例

应用情况

创建可勾选的动作（如工具栏按钮）

QAction *toggleToolbarAction = new QAction("Show Toolbar", this);
toggleToolbarAction->setCheckable(true);
toggleToolbarAction->setChecked(true);  // 默认显示

connect(toggleToolbarAction, &QAction::toggled, [=](bool checked) {
    toolbar->setVisible(checked);
});

使用标准动作（如复制、粘贴）

// 使用 Qt 预定义的标准动作
QAction *copyAction = new QAction(QIcon::fromTheme("edit-copy"), "Copy", this);
copyAction->setShortcut(QKeySequence::Copy);  // 自动适配平台（Ctrl+C 或 Command+C）
connect(copyAction, &QAction::triggered, textEdit, &QTextEdit::copy);

应用场景

//菜单
QMenu *fileMenu = menuBar()->addMenu("File");
fileMenu->addAction(openAction);
fileMenu->addAction(saveAction);
fileMenu->addSeparator();  // 添加分隔线
fileMenu->addAction(exitAction);

//工具栏
QToolBar *toolbar = addToolBar("Main Toolbar");
toolbar->addAction(openAction);
toolbar->addAction(saveAction);

//快捷键
saveAction->setShortcut(QKeySequence("Ctrl+S"));
// 或使用标准快捷键
saveAction->setShortcut(QKeySequence::Save);

Qt 提供了许多预定义的标准快捷键，常见的包括：

常量描述Windows/LinuxmacOS
QKeySequence::Open打开文件Ctrl+OCommand+O
QKeySequence::Save保存文件Ctrl+SCommand+S
QKeySequence::Copy复制Ctrl+CCommand+C
QKeySequence::Paste粘贴Ctrl+VCommand+V
QKeySequence::Cut剪切Ctrl+XCommand+X
QKeySequence::Undo撤销Ctrl+ZCommand+Z
QKeySequence::Redo重做Ctrl+YCommand+Shift+Z
QKeySequence::Find查找Ctrl+FCommand+F
QKeySequence::Quit退出应用Ctrl+QCommand+Q

1.3 QAction与QPushButton/QToolButton关系

在 Qt 框架中，QAction、QPushButton 和 QToolButton 都是用于用户交互的组件，但它们的角色和设计模式有所不同。

QAction

QAction 是一个抽象的用户交互操作，代表一个可执行的动作（如 “保存”“复制”“退出”）。

  • 特点：
  1. 不直接显示在界面上，而是通过其他控件（如菜单、工具栏、按钮）触发。
  2. 封装了动作的属性（如文本、图标、快捷键、状态）和回调（槽函数）。
  3. 支持状态管理（如可勾选、可禁用）。

QPushButton

QPushButton 是一个可见的按钮控件，用于触发单次操作。

  • 特点：
  1. 直接显示在界面上，用户可点击。
  2. 通常与特定位置绑定（如对话框、表单）。

QToolButton

QToolButton 是一种轻量级按钮，常用于工具栏。

  • 特点：
  1. 设计更简洁，通常只显示图标（可搭配文本）。
  2. 支持下拉菜单（如组合按钮）。

三者关系

  1. QAction 是核心逻辑的载体：
    定义动作的行为（如点击后执行的函数）和属性（如图标、文本）。
    可被多个控件共享（如同时出现在菜单和工具栏）。
  2. QPushButton/QToolButton 是 QAction 的可视化载体：
    一个 QAction 可关联到多个 QPushButton 或 QToolButton。
    按钮自动继承 QAction 的属性（如文本、图标、启用状态）。
#include <QMainWindow>
#include <QAction>
#include <QPushButton>
#include <QToolButton>
#include <QToolBar>

class MainWindow : public QMainWindow {
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr) : QMainWindow(parent) {
        // 创建动作
        QAction *saveAction = new QAction("保存", this);
        saveAction->setIcon(QIcon(":/icons/save.png"));
        saveAction->setShortcut(Qt::CTRL + Qt::Key_S);
        connect(saveAction, &QAction::triggered, this, &MainWindow::saveFile);

        // 关联到普通按钮
        QPushButton *pushButton = new QPushButton("保存", this);
        pushButton->setDefaultAction(saveAction);

        // 关联到工具栏按钮
        QToolBar *toolBar = addToolBar("工具栏");
        toolBar->addAction(saveAction);  // 自动创建QToolButton

        // 手动创建QToolButton并关联动作
        QToolButton *toolButton = new QToolButton(this);
        toolButton->setDefaultAction(saveAction);
    }

private slots:
    void saveFile() {
        // 保存文件的逻辑
    }
};
控件适用场景示例
QAction抽象定义操作，需在多处复用菜单项、工具栏按钮、快捷键
QPushButton独立的、强调的操作按钮对话框中的 “确定”“取消” 按钮
QToolButton工具栏中的轻量级按钮，常配合图标使用编辑器中的 “复制”“粘贴” 按钮

2. QMenu

在Qt中，QMenu 是用于创建上下文菜单、下拉菜单或弹出菜单的控件，支持多级子菜单、图标、分隔线等功能。

  • QMenu：菜单容器，可包含菜单项（QAction）和子菜单。
  • QAction：菜单项，可包含文本、图标、快捷键等属性。
  • 信号：菜单项被点击时发出 triggered() 信号。

2.1 创建和使用 QMenu

方法1：在Qt Designer中添加

  1. 在Qt Designer中拖入一个 QPushButton 或 QToolButton。
  2. 右键点击按钮，选择"Change objectName"设置名称（如 menuButton）。
  3. 在代码中关联菜单：
    QMenu *menu = new QMenu(this);
menu->addAction("选项1");
menu->addAction("选项2");
ui->menuButton->setMenu(menu);  // 关联按钮和菜单

方法2：在代码中创建

#include <QMenu>
#include <QAction>

// 创建主菜单
QMenu *menu = new QMenu("文件", this);  // 标题仅对下拉菜单有效

// 添加菜单项
QAction *openAction = menu->addAction("打开");
QAction *saveAction = menu->addAction("保存");

// 添加分隔线
menu->addSeparator();

// 添加子菜单
QMenu *exportMenu = menu->addMenu("导出");
exportMenu->addAction("导出为PDF");
exportMenu->addAction("导出为Excel");

// 显示菜单（在鼠标位置弹出）
menu->popup(QCursor::pos());

2.2 常用方法和属性

QMenu 方法

// 添加菜单项
QAction* addAction(const QString &text);
QAction* addAction(const QIcon &icon, const QString &text);

// 添加子菜单
QMenu* addMenu(const QString &title);
QMenu* addMenu(const QIcon &icon, const QString &title);

// 添加分隔线
QAction* addSeparator();

// 设置和获取标题
void setTitle(const QString &title);
QString title() const;

// 弹出菜单
void popup(const QPoint &pos);  // 在指定位置弹出
void exec(const QPoint &pos);   // 模态弹出，阻塞直到菜单关闭

// 添加自定义控件
void addWidget(QWidget *widget);  // 添加任意控件（如QSpinBox）

QAction 常用属性

属性说明
text菜单项文本
icon菜单项图标
shortcut快捷键（如 Ctrl+O）
checkable是否可勾选
checked勾选状态（对可勾选菜单项有效）
enabled是否启用
visible是否可见

** 信号与槽连接**
QMenu和QAction提供多种信号，常用的有：

// QAction 信号
void triggered(bool checked = false);  // 菜单项被点击
void toggled(bool checked);            // 可勾选菜单项状态变化

// QMenu 信号
void aboutToShow();    // 菜单即将显示
void aboutToHide();    // 菜单即将隐藏
void triggered(QAction *action);  // 任意菜单项被点击

示例：连接信号与槽

// 方式1：直接连接QAction的triggered信号
connect(openAction, &QAction::triggered, this, &MyClass::openFile);

// 方式2：通过QMenu的triggered信号获取被点击的action
connect(menu, &QMenu::triggered, [=](QAction *action) {
    if (action == openAction) {
        openFile();
    } else if (action == saveAction) {
        saveFile();
    }
});

// 方式3：处理可勾选菜单项
QAction *autoSaveAction = menu->addAction("自动保存");
autoSaveAction->setCheckable(true);
connect(autoSaveAction, &QAction::toggled, [=](bool checked) {
    setAutoSave(checked);
});

2.3 创建上下文菜单（右键菜单）

// 为widget设置上下文菜单策略
widget->setContextMenuPolicy(Qt::CustomContextMenu);

// 连接自定义上下文菜单信号
connect(widget, &QWidget::customContextMenuRequested,
        this, &MyClass::showContextMenu);

// 实现上下文菜单显示函数
void MyClass::showContextMenu(const QPoint &pos) {
    QMenu menu(this);
    menu.addAction("复制");
    menu.addAction("粘贴");
    menu.addSeparator();
    menu.addAction("删除");
    
    // 转换为全局坐标
    QPoint globalPos = widget->mapToGlobal(pos);
    menu.exec(globalPos);  // 模态显示菜单
}

2.4 注意事项

  • 菜单项所有权：通过 addAction() 添加的菜单项由QMenu管理，无需手动删除。
  • 模态与非模态：exec() 是模态调用，会阻塞直到菜单关闭；popup() 是非模态的。
  • 性能考虑：动态生成大量菜单项时，建议使用 aboutToShow 信号延迟创建。
  • 跨平台一致性：不同平台的菜单样式可能略有差异，可通过Style Sheets统一外观。
Qt界面篇：Qt停靠控件QDockWidget、树控件QTreeWidget及属性控件QtTreePropertyBrowser的使用
欧特GO
01-04 2984
Qt界面篇：Qt停靠控件QDockWidget、树控件QTreeWidget及属性控件QtTreePropertyBrowser的使用
Qt控件简单介绍
qq_30725967的博客
02-13 9035
Qt可分为QCheckBox、QPushButton等基础控件和QListView、QCalendarWidget等高级控件，QPushButtonGroup、QCroupBox等同属性的组合控件，以及抽象控件三大类。
Qt编写自定义控件：流程进度展示控件
友善啊，朋友的博客
11-24 2735
代码： #ifndef WIDGET_H #define WIDGET_H #include <QWidget> //流程进度展示控件 class ProcessProgressDisplayWidget : public QWidget { Q_OBJECT public: ProcessProgressDisplayWidget(QWidget *parent = nullptr); ~ProcessProgressDisplayWidget()overri
Qt编写自定义控件：图片显示控件
友善啊，朋友的博客
10-23 3136
#ifndef PICTUREVIEWINGCONTROL_H #define PICTUREVIEWINGCONTROL_H #include <QWidget> class PictureViewingControl : public QWidget { Q_OBJECT public: PictureViewingControl(QWidget * parent = nullptr); ~PictureViewingControl(); void s.
QT常用控件
微小冷的学习笔记
05-04 2487
对于任何GUI库，绝大多数控件都属于不必学习的内容。其原因在于，控件量比较大，同时学习门槛十分低，某些知识点过于杂乱，学了之后很难记住。 大多数介绍GUI编程的书籍，都喜欢用控件库来水字数，而与其看这些字数，还不如看官方文档。 所以本节将一些常用的控件全部罗列出来，如下图所示 其中，绝大多数动作的添加方式，都是右键转到槽，而最常用的几种为 clicked()：点击时执行函数。 stateChanged()：状态变化时执行函数，还有一系列xxChanged都表示xx变化时执行，这个函数往往以变化后的值为参
qt控件
g200407331的专栏
05-06 2672
专业各种自定义控件编写+UI定制+输入法定制+视频监控+工业控制+仪器仪表+嵌入式linux+各种串口网络通信，童叟无欺，量大从优，欢迎咨询购买定制！你刚好需要，我正好专业！QQ：517216493 微信：feiyangqingyun 博客园 管理 Qt编写自定义控件大全 设计师designer完整源码（仅限Qt4）：https://pan.baidu.com/s/1...
Qt 自定义控件
qq_43420088的博客
04-15 1132
你可以继承 QWidget 或者其他现有的 Qt 控件类来创建自定义控件。Q_OBJECTpublic:// 设置控件的初始大小protected:// 绘制事件：自定义按钮的外观// 设置按钮的背景色// 设置文本颜色// 鼠标点击事件：模拟按钮点击// 发射点击信号signals:// 自定义的点击信号Qt 支持使用样式表（QSS）自定义控件的样式，可以在自定义控件中结合 QSS 来设置控件的外观。
Qt控件使用方法技巧合集
^_^
09-16 3319
Qt控件使用方法合集
QT教程：基本控件及相关类的介绍和使用
Mr_zhang1911116的博客
03-11 3270
一、QString类： Qt提供了自己的字符串处理类，不用担心内存分配以及关于\0结尾的这些注意事项，QSting会自动对占用的内存进行扩充，链接非常的迅速 实例： QString str = "hello"; str += "world"; //拼接字符串操作 对象函数： str.append("hello")：在字符串末尾追加一个字符串，也是拼接动作 str.setNum(数值)：将数值转为字符串存放 str.toLower()：将字符串转为全小写并返回 str.toUpper(
08 Qt自绘制日历控件：摆脱丑的让人无语的原生QCalendarWidget
进击的程序员
02-29 2207
在QtGui中，日历控件是一种非常常用的用户界面元素，用于显示和选择日期。Qt提供了一个原生的日历控件类真的丑的让人窒息！那么在这时候，也就需要我们不得不对其外观进行自定义绘制，以满足特定的设计需求。在本文中，我们将介绍如何使用Qt的自定义绘制功能来对原生日历控件进行个性化定制。以上就是今天要分享的：Qt如何实现定制日历组件的内容！既聊思路，也说代码！我们下次继续分享自定义风格扩展组件！PS:本专栏所有篇幅涉及的UI扩展组件类，会封装成插件动态库，感兴趣的同学可以留言哦。
Qt控件源码宝库：涵盖201个控件，支持Qt4至Qt6，适用于多平台UI开发
04-11
内容概要：本文介绍了一个名为“Qt控件源码宝库”的资源，该资源包含了201个Qt控件，涵盖了丰富的控件类型如仪表盘、进度条、温度计等，适用于Qt4、Qt5和Qt6版本。这些控件具有零耦合的特点，可以方便地集成到项目中...
Qt控件大全
12-21
在深入探讨Qt控件大全之前，我们先要理解Qt是什么。Qt是一个跨平台的应用程序开发框架，由挪威的Qt Company开发并维护，广泛应用于桌面、移动以及嵌入式设备的软件开发。Qt提供了丰富的控件库，使得开发者可以构建出...
Qt控件集合下载
01-09
**Qt控件集合详解** Qt是一款跨平台的C++图形用户界面应用程序开发框架，它提供了丰富的控件和API，使得开发者能够创建出美观且功能强大的应用程序。本集合中包含了一系列Qt编写的控件，既有开源作品也有原创设计，...
【QT】一个界面中嵌入其它界面（二）
weixin_41920367的博客
05-19 297
此代码可直接复制到 Qt 项目中编译运行，确保在。以下是使用 QStackedWidget。首先创建两个简单的子界面类，用于嵌入到。启动应用程序并显示主窗口。
第50天-使用Python+Qt+DeepSeek开发AI运势测算
suny8的专栏
05-20 249
self.output_area.append(f"\n【{selected_category}】AI回复：\n{ai_response}"){"role": "system", "content": "你是一个专业的助手，请根据分类提供最佳回答"},self.output_area.append(f"\n[{record[3]}] 分类：{record[0]}")self.category_combo.addItems(["运势", "图片", "建议", "其他"])
C++ QT图片查看器
修也
05-15 741
【代码】C++ QT图片查看器。
Qt 信号和槽的补充（10）
2402_83272216的博客
05-17 1200
自定义信号带参数版本代码的实现及其作用 + 信号和槽存在的意义
C++ QT 与 win32 窗口可以互操作
修也
05-20 225
【代码】C++ QT 与 win32 窗口可以互操作。
Qt功能区：Ribbon控件
最新发布
qingttqing的博客
05-21 645
实现功能：设置程序窗口的样式RibbonThemeOffice2013, ///< office2013主题RibbonThemeOffice2016Blue, ///< office2016-蓝色主题RibbonThemeOffice2021Blue, ///< office2021-蓝色主题RibbonThemeWindows7, ///< win7主题RibbonThemeDark, ///< 暗色主题SARibbonComboBox直接继承于QComboBox，并没有添加什么函数。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值