Qt WinAPI - Урок 005. Глобальный HotKey WinAPI в Qt 5

Qt, HotKey, RegisterHotKey, UnregisterHotKey, WinAPI, горячие клавиши

Для работы с глобальными HotKey в Qt 5 присутствует виртуальный метод nativeEvent . Данный метод заменил методы winEvent , x11Event , macEvent из Qt 4.8.

Фишка в работе HotKey с Qt заключается в том, что если окно находится не в фокусе, то есть оно, например, будет свёрнуто в системный трей, то тогда зарегистрированные QShortcut работать просто не будут. Поэтому необходимо работать с глобальными событиями от операционной системы, то есть перейти к реализации платформозависимой части кода в приложении на Qt.

RegisterHotKey

В данном примере разберём вариант работы с WinAPI . Для этого воспользуемся функцией RegisterHotKey.

BOOL WINAPI RegisterHotKey(
  _In_opt_ HWND hWnd,
  _In_     int  id,
  _In_     UINT fsModifiers,
  _In_     UINT vk
);

Параметры RegisterHotKey

hWnd [in, optional]

Тип: HWND
Обработчик окна, которое будет принимать сообщения WM_HOTKEY , которые будут генерироваться горячей клавишей.

id [in]

Тип: int
Идентификатор горячих клавиш. Если hWnd параметр является NULL, тогда горячие клавиши ассоциируются с текущим потоком, а не с конкретным окном.

fsModifiers [in]

Тип: UINT
Клавиши модификаторы, которые должны быть нажаты в сочетании с указанной клавишей в uVirtKey параметре для создания сообщения WM_HOTKEY. fsModifiers параметр может быть комбинацией следующих значений.

  • MOD_ALT 0x0001 - Должна удерживаться клавиша ALT;
  • MOD_CONTROL 0x0002 - Должна удерживаться клавиша CTRL;
  • MOD_NOREPEAT 0x4000 - Изменяет поведение HotKey, чтобы клавиатура не генерировала несколько сообщений HotKey. В Windows Vista данный флаг не поддерживается.
  • MOD_SHIFT 0x0004 - Должна удерживаться клавиша SHIFT;
  • MOD_WIN 0x0008 - Должна удерживаться клавиша WINDOWS. Это клавиша с логотипом Windows.

vk [in]

Тип: UINT
Код виртуальных клавиш для HotKey.

UnregisterHotKey

Отключение сочетания горячих клавиш.

BOOL WINAPI UnregisterHotKey(
  _In_opt_ HWND hWnd,
  _In_     int  id
);

Параметры UnregisterHotKey

hWnd [in, optional]

Тип: HWND
Обработчик окна ассоциированный с горячей клавишей, который должен быть освобождён. Этот параметр должен быть NULL, если не ассоциирован с окном.

id [in]

Тип: int
Идентификатор сочетания горячих клавиш, который должен быть освобождён.

Пример работы с HotKey в WinAPI

Создадим проект для работы с HotKey. В данном проекте будет присутствовать объект класса QSystemTrayIcon. Будем скрывать приложение в системный трей и проверять сочетание горячих клавиш. Таким сочетанием будет "ALT+SHIFT+D" , например. В данном проекте обработчиком горячих клавиш будет MainWindow. Обработка сочетания горячих клавиш будет производиться в nativeEvent.

Проверку на сочетание выбранных горячих клавиш будем производить с помощью qDebug().

mainwindow.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QSystemTrayIcon>
#include "windows.h" // Подключаем библиотеку WinAPI

namespace Ui {
class MainWindow;
}

class MainWindow : public QMainWindow
{
    Q_OBJECT

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

protected:
    // Метод для обработки native событий от ОС в Qt
    bool nativeEvent(const QByteArray &eventType, void *message, long *result);

private slots:
    void iconActivated(QSystemTrayIcon::ActivationReason reason);

private:
    Ui::MainWindow *ui;
    QSystemTrayIcon *trayIcon;
};

#endif // MAINWINDOW_H

mainwindow.cpp

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QDebug>

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    /* Иконка системного трея нужна для того, чтобы
     * окно приложения было не в фокусе
     * */
    trayIcon = new QSystemTrayIcon(this);
    trayIcon->setIcon(this->style()->standardIcon(QStyle::SP_ComputerIcon));
    trayIcon->show();

    connect(trayIcon, SIGNAL(activated(QSystemTrayIcon::ActivationReason)),
            this, SLOT(iconActivated(QSystemTrayIcon::ActivationReason)));

    // Регистрируем HotKey "ALT+SHIFT+D"
    RegisterHotKey((HWND)MainWindow::winId(),   // Устанавливаем системный идентификатор окна виджета, который будет обрабатывать HotKey
                   100,                         // Устанавливаем идентификатор HotKey
                   MOD_ALT | MOD_SHIFT,         // Устанавливаем модификаторы
                   'D');                        // Определяем Горячую Клавишу для HotKey
}

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

bool MainWindow::nativeEvent(const QByteArray &eventType, void *message, long *result)
{
    Q_UNUSED(eventType)
    Q_UNUSED(result)
    // Преобразуем указатель message в MSG WinAPI
    MSG* msg = reinterpret_cast<MSG*>(message);

    // Если сообщение является HotKey, то ...
    if(msg->message == WM_HOTKEY){
        // ... проверяем идентификатор HotKey
        if(msg->wParam == 100){
            // Сообщаем об этом в консоль
            qDebug() << "HotKey worked";
            return true;
        }
    }
    return false;
}

void MainWindow::iconActivated(QSystemTrayIcon::ActivationReason reason)
{
    switch (reason){
    case QSystemTrayIcon::Trigger:
        !isVisible() ? show() : hide();
        break;
    default:
        break;
    }
}

Примечание

Для того, чтобы проект скомпилировался с комплектом сборки MSVC, добавьте в pro файл проекта следующие строки:

win32-msvc*{
    LIBS += -luser32
}

Итог

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

Видеоурок

Возврат 10% от суммы заказа отеля на Booking
Возврат 10% от суммы заказа отеля на Booking
Предлагаем ссылку с 10% возвратом от суммы заказа при бронировании отеля через Booking
Поддержать автора Donate

Комментарии

Только авторизованные пользователи могут публиковать комментарии.
Пожалуйста, авторизуйтесь или зарегистрируйтесь
TT
13 июня 2019 г. 19:01
Taimoor Tanweer

C++ - Тест 001. Первая программа и типы данных

  • Результат:66баллов,
  • Очки рейтинга-1
TT
13 июня 2019 г. 18:51
Taimoor Tanweer

C++ - Тест 002. Константы

  • Результат:75баллов,
  • Очки рейтинга2
ВМ
13 июня 2019 г. 12:30
Ваня Мороз

C++ - Тест 001. Первая программа и типы данных

  • Результат:100баллов,
  • Очки рейтинга10
Последние комментарии
i
17 июня 2019 г. 6:10
ingenfly

Только по осям xAxis2, уAxis2 значения начинаются с 0. Почему-то xAxis2 и xAxis не синхронизированы по данным. Ну и QCustomPlot последний.
16 июня 2019 г. 20:21
Евгений Легоцкой

Добрый день. Ну точно также добавляете ту же самую информацию на ось xAxis2, только добавляете другое форматирование customPlot->xAxis2->setDateTimeFormat("hh:mm"); если я ...
EF
14 июня 2019 г. 13:56
Egor Fomin

Спасибо за ваш ответ, у меня получилось реализовать это. Тем не менее появилась другая проблема, поэтому опять надеюсь на вашу помощь. Скажем, я уже выставил точки и они соеденены. Когда я нач...
d
13 июня 2019 г. 14:47
damix

Можно классу, который описывает точку, добавить сигнал, который подавать (emit), когда точка перемещается (переопределить mouseMoveEvent или mouseReleaseEvent). Так вот эти сигналы у каждой из...
i
13 июня 2019 г. 14:09
ingenfly

Здравствайте! Подскажите, пожалуйста: customPlot->xAxis2->setTickLabels(true); //Здесь включается отображение данных на оси xAxis2. а можно как-то продублировать информацию cus...
Сейчас обсуждают на форуме
I
19 июня 2019 г. 13:41
Intruder

Всем добрый день. При разборе XML файла наткнулся на тег вот такого плана: <TagName attribute1="value1" attribute2="value2" /> При попытке проверить на наличие такого элеме...
19 июня 2019 г. 12:55
Михаиллл

Скажите пожалуйста, как его в таком случае перемещать и удалять?
18 июня 2019 г. 19:50
Дмитрий

Большое спасибо! SDK заработал.К сожалению удалось продвинутся только на один шаг. При сборке чистого проекта NDK выдаёт следующие ошибки C:\Android\ndk-bundle/toolchains/arm-linux-andr...
18 июня 2019 г. 16:59
Михаиллл

Добрый день.В этом учебнике представлен код INSTALLED_APPS = ( ... 'rest_framework', 'snippets.apps.SnippetsConfig',) На строчке 'snippets.apps.SnippetsConf...
18 июня 2019 г. 14:24
Михаиллл

Спасибо, работает.Послушаю вашего совета.
Ищу работу?
25,000.00 руб. - 30,000.00 руб.
Разработчик Qt/C++
Barnaul, Altai Krai, Russia

Для зарегистрированных пользователей на сайте присутствует минимальное количество рекламы

EVILEG
О нас
Услуги
Присоединяйтесь к нам
© EVILEG 2015-2019
Рекомендует хостинг TIMEWEB