Реклама

Qt/C++ - Урок 012. QShortcut или Горячие клавиши в Qt

TutorialQtQShortcut, QShortcut example, Qt304

Даже в официальной документации на тему QShortcut написано не так много, поэтому это скорее заметка, чтобы не забыть, а не полноценная статья. Всего лишь несколько слов о том, как подключить объект QShortcut, который будет отвечать за обработку нажатия горячей клавиши или сочетания горячих клавиш, например Ctrl + D .

Программный код был написан в QtCreator 3.3.1 на основе Qt 5.4.1.

Структура проекта для QShortcut

Структура проекта настолько тривиальна, что я даже не буду приводить её в данной заметке. Ограничусь лишь теми словами, что мы будем работать с двумя файлами:

  • mainwindow.h
  • mainwindow.cpp

А файл mainwindow.ui даже трогать в этом проекте не будем. Как он будет создан по умолчанию, так его и оставим.

mainwindow.h

В заголовочном файле потребуется объявить два объекта QShortcut , а также методы для обработки нажатий горячих клавиш.

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QShortcut>
#include <QMessageBox>

namespace Ui {
class MainWindow;
}

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    explicit MainWindow(QWidget *parent = 0);
    ~MainWindow();

private slots:
    // слоты для обработки нажатий горячих клавиш
    void slotShortcutF11();
    void slotShortcutCtrlD();

private:
    Ui::MainWindow  *ui;
    QShortcut       *keyF11;    // объект горячей клавиши F11
    QShortcut       *keyCtrlD;  // объект сочетания клавиш Ctrl + D
};

#endif // MAINWINDOW_H

mainwindow.cpp

Минимальная настройка горячей клавиши заключается:

  • в инициализации объекта, который будет отвечать за горячую клавишу или сочетание горячих клавиш;
  • передаче кодов горячих клавиш в объект;
  • подключении СЛОТа-обработчика нажатий горячих клавиш к объекту QShortcut .
#include "mainwindow.h"
#include "ui_mainwindow.h"

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    keyF11 = new QShortcut(this);   // Инициализируем объект
    keyF11->setKey(Qt::Key_F11);    // Устанавливаем код клавиши
    // цепляем обработчик нажатия клавиши
    connect(keyF11, SIGNAL(activated()), this, SLOT(slotShortcutF11()));

    keyCtrlD = new QShortcut(this); // Инициализируем объект
    keyCtrlD->setKey(Qt::CTRL + Qt::Key_D); // Устанавливаем сочетание клавиш
    // подключаем обработчик нажатия клавиши
    connect(keyCtrlD, SIGNAL(activated()), this, SLOT(slotShortcutCtrlD()));
}

MainWindow::~MainWindow()
{
    delete ui;
}

/* Слот для обработки нажатия клавиши F11
 * */
void MainWindow::slotShortcutF11()
{
    /* В этом обработчике сделаем переключение приложения
     * в полноэкранный режим и обратно в нормальный режим окна
     * */
    if(this->isFullScreen()){
        this->showNormal();
    } else {
        this->showFullScreen();
    }
}

/* Слот для обработки сочетания клавиш Ctrl + D
 * */
void MainWindow::slotShortcutCtrlD()
{
    /* Для обработки сочетания клавив Ctrl + D
     * сделаем информационный MessageBox,
     * который будет сигнализировать о том, что было нажато данное
     * сочетание клавиш
     * */
    QMessageBox::information(this,
                             "Горячая клавиша",
                             "Мои поздравления!!! Горячая клавиша работает",
                             QMessageBox::Ok);
}

Итог

В данном примере показан один из способов задания сочетания горячих клавиш, тогда как официальная документация приводит примеры нескольких способов:

setKey(0);                  // сигнал не вызывается
setKey(QKeySequence());     // сигнал не вызывается
setKey(0x3b1);              // Указание кода клавиши
setKey(Qt::Key_D);          // 'd', указание кода клавиши через директиву define
setKey('q');                // 'q', указание кода клавиши через символ
setKey(Qt::CTRL + Qt::Key_P);       // Ctrl+P, указание сочетания клавиш через директивы define
setKey("Ctrl+P");           // Ctrl+P, прямое написание сочетания клавиш

/* Сочетания клавиш необходимо прописывать через знак "+" */

В результате у Вас должно получиться приложение, которое по нажатию клавиши F11 разворачивается в полноэкранный режим и сворачивается обратно в нормальное отображение окна, а также по нажатию сочетания клавиш Ctrl + D вызывает MessageBox , который сигнализирует о нажатии этого сочетания клавиш.

Приложение с применением QShortcut
@EVILEG 30 августа 2015 г. 20:33

Реклама

Реклама

Комментарии

Комментарии

Только авторизованные пользователи могут оставлять комментарии.
Пожалуйста, Авторизуйтесь или Зарегистрируйтесь

Реклама

Реклама