Qt/C++ - Сабақ 002. QSystemTrayIcon немесе науаға қолданбаны қалай азайтуға болады?

QSystemTrayIcon, Tray, qt, трей

[PyQt5/Python] туралы ұқсас мақала(https://evileg.com/en/post/68/)

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

Ендеше келесі сұрақтарды қарастырайық:

• Бағдарламаны науаға азайтуға қалай үйрету керек;
• Қолданбаңыздың науа белгішесі үшін контекстік мәзірді қалай жасауға болады;
• Қажет болмаса, бұл мүмкіндікті қалай өшіруге болады.

Код Qt 5.4.1 негізінде QtCreator 3.3.1-де жазылған.

QSystemTrayIcon үшін жоба құрылымы

Жоба әдепкі бойынша файлдарды жасайтын Qt Widgets қолданбасы ретінде жасалған:

• Tray.pro - профиль;
• mainwindow.h – қосымшаның негізгі терезесінің тақырып файлы;
• mainwindow.cpp – терезенің бастапқы коды;
• main.cpp – қолданба басталатын негізгі бастапқы файл;
• mainwindow.ui – қолданбаның негізгі терезесінің формасы.

Ескерту. Мен негізгі кодтың логикасын қажетсіз ақпаратпен шатастырмау үшін дизайнерде интерфейстің көп бөлігін жасаймын. Шындығында, бұл тек дәм мен әдетке байланысты мәселе .

mainwindow.ui

Науаны тексеруге арналған терезе пішіні Сынақ үшін құсбелгісі бар қарапайым және ерекше пішінді жасайық.

QCheckBox нысанының атауы trayCheckBox

Tray.pro

Бұл файл әдепкі параметрлермен қалды.

#-------------------------------------------------
#
# Project created by QtCreator 2015-08-10T17:18:30
#
#-------------------------------------------------

QT       += core gui

greaterThan(QT\_MAJOR\_VERSION, 4): QT += widgets

TARGET = Tray
TEMPLATE = app


SOURCES += main.cpp\
        mainwindow.cpp

HEADERS  += mainwindow.h

FORMS    += mainwindow.ui

main.cpp

Бұл файл да өзгертілмеген.

#include "mainwindow.h"
#include <QApplication>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    MainWindow w;
    w.show();

    return a.exec();
}

mainwindow.h

Тақырып файлы қазірдің өзінде өзгертілуде, өйткені бізге терезені жабу оқиғасын қадағалау керек, сонымен қатар қолданба науасы белгішесі үшін басу өңдеушісін жасау керек. Сондай-ақ осы файлға барлық қажетті кітапханаларды қосуды ұмытпаңыз. Әйтпесе, жоба құрастырылмайды.

#ifndef MAINWINDOW\_H
#define MAINWINDOW\_H

#include <QMainWindow>
#include <QCloseEvent>
#include <QSystemTrayIcon>
#include <QAction>

namespace Ui {
class MainWindow;
}

class MainWindow : public QMainWindow
{
    Q\_OBJECT

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

protected:
    /* Виртуальная функция родительского класса в нашем классе
     * переопределяется для изменения поведения приложения,
     *  чтобы оно сворачивалось в трей, когда мы этого хотим
     */
    void closeEvent(QCloseEvent * event);

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"

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

    /* Инициализируем иконку трея, устанавливаем иконку из набора системных иконок,
     * а также задаем всплывающую подсказку
     * */
    trayIcon = new QSystemTrayIcon(this);
    trayIcon->setIcon(this->style()->standardIcon(QStyle::SP\_ComputerIcon));
    trayIcon->setToolTip("Tray Program" "\n"
                         "Работа со сворачиванием программы трей");
    /* После чего создаем контекстное меню из двух пунктов*/
    QMenu * menu = new QMenu(this);
    QAction * viewWindow = new QAction(trUtf8("Развернуть окно"), this);
    QAction * quitAction = new QAction(trUtf8("Выход"), this);

    /* подключаем сигналы нажатий на пункты меню к соответсвующим слотам.
     * Первый пункт меню разворачивает приложение из трея,
     * а второй пункт меню завершает приложение
     * */
    connect(viewWindow, SIGNAL(triggered()), this, SLOT(show()));
    connect(quitAction, SIGNAL(triggered()), this, SLOT(close()));

    menu->addAction(viewWindow);
    menu->addAction(quitAction);

    /* Устанавливаем контекстное меню на иконку
     * и показываем иконку приложения в трее
     * */
    trayIcon->setContextMenu(menu);
    trayIcon->show();

    /* Также подключаем сигнал нажатия на иконку к обработчику
     * данного нажатия
     * */
    connect(trayIcon, SIGNAL(activated(QSystemTrayIcon::ActivationReason)),
            this, SLOT(iconActivated(QSystemTrayIcon::ActivationReason)));
}

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

/* Метод, который обрабатывает событие закрытия окна приложения
 * */
void MainWindow::closeEvent(QCloseEvent * event)
{
    /* Если окно видимо и чекбокс отмечен, то завершение приложения
     * игнорируется, а окно просто скрывается, что сопровождается
     * соответствующим всплывающим сообщением
     */
    if(this->isVisible() && ui->trayCheckBox->isChecked()){
        event->ignore();
        this->hide();
        QSystemTrayIcon::MessageIcon icon = QSystemTrayIcon::MessageIcon(QSystemTrayIcon::Information);

        trayIcon->showMessage("Tray Program",
                              trUtf8("Приложение свернуто в трей. Для того чтобы, "
                                     "развернуть окно приложения, щелкните по иконке приложения в трее"),
                              icon,
                              2000);
    }
}

/* Метод, который обрабатывает нажатие на иконку приложения в трее
 * */
void MainWindow::iconActivated(QSystemTrayIcon::ActivationReason reason)
{
    switch (reason){
    case QSystemTrayIcon::Trigger:
        /* Событие игнорируется в том случае, если чекбокс не отмечен
         * */
        if(ui->trayCheckBox->isChecked()){
            /* иначе, если окно видимо, то оно скрывается,
             * и наоборот, если скрыто, то разворачивается на экран
             * */
            if(!this->isVisible()){
                this->show();
            } else {
                this->hide();
            }
        }
        break;
    default:
        break;
    }
}

Барлығы

Жоба сәтті құрастырылған жағдайда, қолданбаңыз науаға оңай оралады. Қолданбаның QSystemTrayIcon көмегімен жұмыс істеу мысалы келесі бейнеде көрсетілген: