qt QShortcut详解

1、概述

QShortcut是Qt框架中的一个类,它提供了一种创建键盘快捷键的方式。通过QShortcut,开发者可以将特定的键盘组合(如Ctrl+C、Alt+F4等)与应用程序中的动作(如复制、关闭窗口等)关联起来。当用户在应用程序中按下指定的键盘组合时,QShortcut会触发相应的动作。QShortcut简化了键盘快捷键的创建和管理,使得开发者能够为用户提供更加高效和便捷的交互方式。

2、重要方法

QShortcut类提供了多个方法来设置和管理快捷键。以下是一些重要的方法:

  • QShortcut(const QKeySequence &key, QWidget *parent, const char *member = nullptr, const char *ambient = nullptr): 构造函数,用于创建一个QShortcut对象,并指定快捷键、父组件、要触发的槽函数和是否作为环境快捷键(环境快捷键在应用程序的任何地方都可以触发,而不仅仅是父组件中)。
  • setKey(const QKeySequence &key): 设置快捷键。
  • key() const: 返回当前设置的快捷键。
  • setContext(Qt::ShortcutContext context): 设置快捷键的上下文(如窗口快捷键、应用程序快捷键等)。
  • context() const: 返回当前设置的快捷键上下文。
  • setAutoRepeat(bool enabled): 设置是否启用自动重复功能(当按住快捷键时,是否持续触发动作)。
  • isAutoRepeatEnabled() const: 返回是否启用了自动重复功能。
  • activated() const: 这是一个"伪方法",用于连接信号。实际上,你应该连接activated(const QKeySequence &)信号。

注意:activated()方法实际上是一个信号,但在某些文档或示例中可能会误称为方法。正确的使用方式是连接activated(const QKeySequence &key)信号到槽函数。

3、重要信号

QShortcut类最重要的信号是:

  • void activated(): 当快捷键被触发时,这个信号被发射。
  • void activatedAmbiguously():快捷键被模糊触发时发出信号。
4、常用枚举类型

以下是 QShortcut 类中一些常用的枚举类型及其简要介绍:

Qt::ShortcutContext快捷键上下文:

  • Qt::WindowShortcut:快捷键在窗口范围内触发。

  • Qt::ApplicationShortcut:快捷键在整个应用程序范围内触发。

  • Qt::WidgetShortcut:快捷键在小部件范围内触发。

    #include <QApplication>
    #include <QMainWindow>
    #include <QShortcut>
    #include <QKeySequence>
    #include <QDebug>

    class MainWindow : public QMainWindow {
    Q_OBJECT

    public:
    MainWindow(QWidget *parent = nullptr) : QMainWindow(parent) {
    // 创建一个快捷键,设置为Ctrl+Q,并连接到close()槽函数
    QShortcut *quitShortcut = new QShortcut(QKeySequence(Qt::CTRL + Qt::Key_Q), this);
    connect(quitShortcut, &QShortcut::activated, this, &QMainWindow::close);

          // 创建一个调试快捷键,设置为Ctrl+D,并连接到自定义槽函数
          QShortcut *debugShortcut = new QShortcut(QKeySequence(Qt::CTRL + Qt::Key_D), this);
          connect(debugShortcut, &QShortcut::activated, this, &MainWindow::debugShortcutActivated);
      }
    

    private slots:
    void debugShortcutActivated() {
    qDebug() << "Debug shortcut activated!";
    }
    };

    int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

      MainWindow window;
      window.show();
    
      return app.exec();
    

    }

觉得有帮助的话,打赏一下呗。。

相关推荐
「QT(C++)开发工程师」5 小时前
【qt版本概述】
开发语言·qt
一路冰雨9 小时前
Qt打开文件对话框选择文件之后弹出两次
开发语言·qt
老赵的博客10 小时前
QT 自定义界面布局要诀
开发语言·qt
码码哈哈0.010 小时前
VSCode 2022 离线安装插件QT VSTOOl报错此扩展不能安装在任何当前安装的产品上。
ide·vscode·qt
feiyangqingyun14 小时前
Qt/C++离线地图的加载和交互/可以离线使用/百度和天地图离线/支持手机上运行
c++·qt·qt天地图·qt离线地图·qt地图导航
gz94561 天前
windows下,用CMake编译qt项目,出现错误By not providing “FindQt5.cmake“...
开发语言·qt
「QT(C++)开发工程师」1 天前
Ubuntu 26.04 LTS 大升级:Qt 6 成为未来新引擎
qt
兆。1 天前
python实战案例----使用 PyQt5 构建简单的 HTTP 接口测试工具
爬虫·python·qt
喝哈喝哈1 天前
pycharm中配置pyqt5
python·qt·pycharm
Qt云程序员1 天前
Qt、C++实现五子棋人机对战与本地双人对战(高难度AI,极少代码)
c++·人工智能·qt