Qt/C++ - Lesson 003. QSettings - How to save application settings?

QSettings, QSettings example, QSettings пример, qt, Настройки, сохранение настроек

Saving application settings - this is one of the first things that beginners learn when working with the Qt framework. For this purpose QSettings class that allows you to save the settings or operating system registry or a text file. In this tutorial you will use the easiest option - it is saving the settings in the operating system registry. In order to ensure the visibility of the store the settings in this tutorial use the draft of the lesson QSystemTrayIcon .

Project structure

The project is created as an application Qt Widgets, where files are created by default:

  • Settings.pro
  • mainwindow.h - header file of the main application window;
  • mainwindow.cpp - source window;
  • main.cpp - the main source file from which the application starts;
  • mainwindow.ui - form of the main application window.

mainwindow.ui

Формочка для QSettings Program

We create a mold for the test, in which two of the following objects will be used:

  • trayCheckBox - checkbox to adjust the behavior of the application;
  • saveButton - button to save the settings, perform the Application;

Settings.pro

Still in the lessons not to amend the draft profile.

#-------------------------------------------------
#
# Project created by QtCreator 2015-08-12T09:31:45
#
#-------------------------------------------------

QT       += core gui

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

TARGET = Settings
TEMPLATE = app


SOURCES += main.cpp\
        mainwindow.cpp

HEADERS  += mainwindow.h

FORMS    += mainwindow.ui

main.cpp

This file is subject to change, since the start of the program is necessary to make information on the application in the operating system registry.

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

int main(int argc, char *argv[])
{
    /*For the adequate application of registration in the operating room
     * Necessary to establish the organization name, domain, organization,
     * As well as the name of the application.
     * All settings are stored in the operating system under these
     * Accounting application data
     * */
    QCoreApplication::setOrganizationName(ORGANIZATION_NAME);
    QCoreApplication::setOrganizationDomain(ORGANIZATION_DOMAIN);
    QCoreApplication::setApplicationName(APPLICATION_NAME);

    QApplication a(argc, argv);
    MainWindow w;
    w.show();

    return a.exec();
}

mainwindow.h

In addition to the methods and objects used in the lesson on QSystemTrayIcon in this file you must add slot to handle pressing, which will be saving settings.

Also, you need to connect to the project header files of the following classes:

  • QSettings;
  • QMessageBox;

And prescribe directives define, to be used when working with QSettings.

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

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

/* Defining */
#define ORGANIZATION_NAME "EVILEG"
#define ORGANIZATION_DOMAIN "www.evileg.ru"
#define APPLICATION_NAME "QSettings Program"

#define SETTINGS_TRAY "settings/tray"

namespace Ui {
class MainWindow;
}

class MainWindow : public QMainWindow
{
    Q_OBJECT

////////////////// Methods of lesson QSystemTrayIcon
public:
    explicit MainWindow(QWidget *parent = 0);
    ~MainWindow();

protected:
    void closeEvent(QCloseEvent * event);
/////////////////////////////////////////////////////

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

    /* Slot button that starts saving application settings
     * */
    void on_saveButton_clicked();

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

#endif // MAINWINDOW_H

mainwindow.cpp

In this class, made the restore application settings when initializing the appearance of the main window and save the settings by pressing the button on saveButton.

#include "mainwindow.h"
#include "ui_mainwindow.h"

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


    /* When you create a main window to perform the installation of the initial parameters
     * Of the settings saved in the operating system
     * */
    QSettings settings(ORGANIZATION_NAME, APPLICATION_NAME);
    /* Set the state of the checkbox of the application settings for a given key.
     * If the key does not exist, it will be set to the default,
     * It is false
     * */
    ui->trayCheckBox->setChecked(settings.value(SETTINGS_TRAY, false).toBool());

    /* Code from lesson to work with QSystemTrayIcon
     * */
   
    /* *** */
}

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

/* The method of the lesson on working with QSystemTrayIcon
 * */
void MainWindow::closeEvent(QCloseEvent * event)
{
    /* *** */
}

/* The method of the lesson on working with QSystemTrayIcon
 * */
void MainWindow::iconActivated(QSystemTrayIcon::ActivationReason reason)
{
   /* *** */
}

/* The method, which accepts key entry beep
 * Performs a save and application settings
 * */
void MainWindow::on_saveButton_clicked()
{
    QSettings settings(ORGANIZATION_NAME, APPLICATION_NAME);
    /* Storing information about vklyuchёnnosti folding function
     * In the tray is manufactured in accordance with the state of the checkbox.
     * */
    if(ui->trayCheckBox->isChecked()){
        settings.setValue(SETTINGS_TRAY, true);
    } else {
        settings.setValue(SETTINGS_TRAY, false);
    }
    settings.sync();

    /* Dialog message, which indicates the success of
     * Save settings
     * */
    QMessageBox::information(this,
                             trUtf8("Сохранение настроек"),
                             trUtf8("Сохранение настроек выполнено успешно"));
}

Conclusion

Upon successful writing the code of the lesson, when you click save settings button, settings will be saved in the operating system registry.

And after the restart settings are restored app. If you save settings checkbox was checked, it will also be marked by the application starts. And the app will behave according to the settings.

We recommend hosting TIMEWEB
We recommend hosting TIMEWEB
Stable hosting, on which the social network EVILEG is located. For projects on Django we recommend VDS hosting.
Support the author Donate
B

Зачем мы добавляли pushButton, если она не используется нигде. Метод on_saveButton_clicked() аналогично нигде не используется и как сигнал не передается?

Вот сразу понятно, что Вы первый день в Qt разработке ))) Ничего плохого не имею ввиду )))

on_saveButton_clicked() - это слот, созданный через Qt Designer, в каких-то статьях я уже это пояснял. Не вижу смысла в каждой статье это объяснять. Такие слоты подключаются при сборке через автоматически генерируемые ui хедеры, поэтому pushButton подключён прямо к этому слоту. Так что всё работает.


Comments

Only authorized users can post comments.
Please, Log in or Sign up
Donate

Hello, Dear Users of EVILEG!!!

If the site helped you, then support the development of the site financially, please.

You can do it by following ways:

Thank you, Evgenii Legotckoi

AS
Dec. 13, 2019, 6:05 a.m.
Aruzhan Seraliyeva

C++ - Тест 003. Условия и циклы

  • Result:50points,
  • Rating points-4
AS
Dec. 13, 2019, 5:47 a.m.
Aruzhan Seraliyeva

C++ - Test 001. The first program and data types

  • Result:40points,
  • Rating points-8
T
Dec. 11, 2019, 4:56 p.m.
Toma

C++ - Тест 003. Условия и циклы

  • Result:50points,
  • Rating points-4
Last comments
Dec. 9, 2019, 3:41 a.m.
Evgenij Legotskoj

Эта ошибка invalid use of incomplete type ‘class Ui::AnotherWindow’ обычно говорит о том, что не найдено определение класса или структуры. Типичная проблема - не подключён заголовочны…
NB
Dec. 9, 2019, 3:36 a.m.
Nikolaj Batmanov

Ну, не настолько со мной всё полхо...))) Вроде бы. Я ж кнопки отрисовываю.
Dec. 9, 2019, 3:14 a.m.
Evgenij Legotskoj

Добрый день. У вас ui файлов по ходу нет. UI файлы используются для вёрстки в графическом дизайнере.
NB
Dec. 9, 2019, 3:05 a.m.
Nikolaj Batmanov

Здравствуйте! Полностью скопировал ваш пример к себе, чтобы разобраться. А он не хочет запускаться, дает ошибку: invalid use of incomplete type ‘class Ui::AnotherWindow’ ui(new Ui…
Dec. 8, 2019, 7:23 a.m.
Evgenij Legotskoj

У меня здесь есть одна старая статья с примером векторного редактора. Там есть ответы на ваши вопросы. Поизучайте Qt/C++ - Урок 072. Пример векторного редактора на Qt QGraphicsItem, QG…
Now discuss on the forum
Dec. 13, 2019, 10:16 a.m.
Ruslan Volshebnik

Да, я посмотрел, вы абсолютно правы. Единственное, если я правильно понял, если срабатывает условие if (aggregates["max_id"] - aggregates["min_id"]) + 1 == aggregates["count"]: return sel…
t
Dec. 13, 2019, 9:53 a.m.
tantrido

Ответ >>
Dec. 13, 2019, 8:39 a.m.
Aleksandr Panjushkin

Вроде да. Только там начинаются вопросы с тем, чтобы виджет бы в фокусе, чтобы до виджета это событие долетало.
DK
Dec. 13, 2019, 7:48 a.m.
Dzhon Kofi

Привет. Есть класс "ждун", который используется на разных виджетах: class WaiterDialog;#define WAITER_DIALOG Singleton<WaiterDialog>::instance()class WaiterDialog : public QObject, …
EVILEG
About
Services
© EVILEG 2015-2019
Recommend hosting TIMEWEB