Qt控件:交互控件

发布于:2025-05-20 ⋅ 阅读:(16) ⋅ 点赞:(0)

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/Linux macOS
QKeySequence::Open 打开文件 Ctrl+O Command+O
QKeySequence::Save 保存文件 Ctrl+S Command+S
QKeySequence::Copy 复制 Ctrl+C Command+C
QKeySequence::Paste 粘贴 Ctrl+V Command+V
QKeySequence::Cut 剪切 Ctrl+X Command+X
QKeySequence::Undo 撤销 Ctrl+Z Command+Z
QKeySequence::Redo 重做 Ctrl+Y Command+Shift+Z
QKeySequence::Find 查找 Ctrl+F Command+F
QKeySequence::Quit 退出应用 Ctrl+Q Command+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 工具栏中的轻量级按钮,常配合图标使用 编辑器中的 “复制”“粘贴” 按钮