Qt WinAPI - 005-сабақ. Qt 5-тегі ғаламдық HotKey WinAPI

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

Qt 5 жаһандық HotKey -мен жұмыс істеу үшін nativeEvent виртуалды әдісі бар. Бұл әдіс winEvent , x11Event , macEvent әдістерін Qt 4.8. нұсқасынан ауыстырды.

Qt көмегімен HotKey -мен жұмыс істеудің айласы мынада: егер терезе фокуста болмаса, яғни, мысалы, ол жүйелік науаға кішірейтіледі, онда тіркелген QShortcut жай ғана жұмыс істемейді. Сондықтан операциялық жүйеден ғаламдық оқиғалармен жұмыс істеу керек, яғни Qt қосымшасында кодтың платформаға тән бөлігін жүзеге асыруға көшу керек.

Жылдам кілтті тіркеңіз

Бұл мысалда WinAPI -мен жұмыс істеу опциясын талдап көрейік. Ол үшін RegisterHotKey. функциясын пайдаланыңыз.

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

RegisterHotKey параметрлері

hWnd [in, міндетті емес]

Түрі: 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 хабарламаларын жасамайтындай жылдам перне әрекетін өзгертеді. Бұл жалаушаға Windows Vista жүйесінде қолдау көрсетілмейді.
• MOD_SHIFT 0x0004 - SHIFT пернесін басып тұру керек;
• MOD_WIN 0x0008 - WINDOWS пернесін басып тұру керек. Бұл Windows логотипінің кілті.

vk [in]

Түрі: UINT
HotKey үшін виртуалды кілттер коды.

Ыстық кілтті тіркеуден шығару

Жылдам пернелер тіркесімін өшіріңіз.

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

HotKey параметрлерін тіркеуден шығару

hWnd [in, міндетті емес]

Түрі: HWND
Босату керек жылдам пернемен байланысты терезе дескрипторы. Тереземен байланыспаса, бұл параметр NULL болуы керек.

id [in]

Түрі: int
Шығарылатын жылдам пернелер тіркесімінің идентификаторы.

WinAPI жүйесінде HotKey көмегімен жұмыс істеу мысалы

HotKey. -мен жұмыс істеу үшін жобаны жасайық. Бұл комбинация "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
}

Барлығы

Бұл бағдарлама кодының жұмысының нәтижесінде қолданба терезесі жүйелік науада жасырылған болса да, жаһандық жылдам пернелер тіркесімі өңделеді. Қолданбаның демонстрациясын бейне оқулықтан көруге болады.

Бейне оқулық