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

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.


Формочка для 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;


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

SOURCES += main.cpp\

HEADERS  += mainwindow.h

FORMS    += mainwindow.ui


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
     * */

    QApplication a(argc, argv);
    MainWindow w;

    return a.exec();


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.


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

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

#define SETTINGS_TRAY "settings/tray"

namespace Ui {
class MainWindow;

class MainWindow : public QMainWindow

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

    void closeEvent(QCloseEvent * event);

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

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

    Ui::MainWindow          * ui;
    QSystemTrayIcon         * trayIcon;

#endif // MAINWINDOW_H


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) :
    ui(new Ui::MainWindow)

    /* When you create a main window to perform the installation of the initial parameters
     * Of the settings saved in the operating system
     * */
    /* 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
     * */
    /* *** */

    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()
    /* Storing information about vklyuchёnnosti folding function
     * In the tray is manufactured in accordance with the state of the checkbox.
     * */
        settings.setValue(SETTINGS_TRAY, true);
    } else {
        settings.setValue(SETTINGS_TRAY, false);

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


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

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

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

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


Only authorized users can post comments.
Please, Log in or Sign up
How to become an author?

Contribute to the evolution of the EVILEG community.

Learn how to become a site author.

Learn it

Good day, Dear Users!!!

I am Evgenii Legotckoi, developer of EVILEG. And it is my hobby project, which helps to learn programming another programmers and developers

If the site helped you, and you want also support the development of the site, than you can donate by following ways


Let me recommend you the excellent hosting on which EVILEG is located.

For many years, Timeweb has been proving his stability.

For projects on Django I recommend VDS hosting

View Hosting Timeweb
May 26, 2020, 11:29 a.m.
Artem Sun-Dun-Chan

C ++ - Test 004. Pointers, Arrays and Loops

  • Result:50points,
  • Rating points-4
May 25, 2020, 11:33 a.m.
Mitja Nagibin

C ++ - Test 004. Pointers, Arrays and Loops

  • Result:50points,
  • Rating points-4
May 25, 2020, 5:05 a.m.

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

  • Result:66points,
  • Rating points-1
Last comments
May 29, 2020, 5:24 a.m.
Aleksandr Leonidov

Django - Tutorial 036. How to add authentication through social networks. VKontakte

Здравствуйте! После клика на ссылку авторизации выдает json словарь с ошибкой: {"error":"invalid_request","error_description":"redirect_uri is incorrect, check application redirect uri in …
May 28, 2020, 3:14 p.m.
Evgenij Legotskoj

Qt/C++ - Lesson 039. How to paint stroke in QSqlTableModel by value in the column?

Ну в моём примере, который в статье сработало так model->setData(model->index(1, 1), 7); Поскольку model->index(1, 0) - это индекс колонки id, которая скрыта, поэтому…
May 28, 2020, 3:08 p.m.
Mihail A

Qt/C++ - Lesson 039. How to paint stroke in QSqlTableModel by value in the column?

Спасибо, завтра првоерю. А model->setData(model->index(1, 0), 7); Тоже заработало?
May 28, 2020, 3:06 p.m.
Evgenij Legotskoj

Qt/C++ - Lesson 039. How to paint stroke in QSqlTableModel by value in the column?

Да, метод data всё-таки влиял, я переписал его так и заработало удаление QVariant TableModel::data(const QModelIndex &idx, int role) const{ if (role == Qt::BackgroundColorRole) {…
May 28, 2020, 2:49 p.m.
Evgenij Legotskoj

Django - Tutorial 011. Adding comments to the site based on Django

Он более функциональный и его функционал объективно лучше поддерживается Django. Из первого, что приходит на ум: Это наличие полей типа Array Поддержка полей для JSON …
Now discuss on the forum
May 29, 2020, 1:55 a.m.
Igor' Poroshin

QTablwView + QSqlQueryModel скрыть пустой столбец

Да, понятно. В данном случае лучше использовать серверную процедуру (если такие поддерживаются), в которой будет проверяться наличие всех пустых строк у нужного столбца и вызываться соответ…
May 28, 2020, 6:21 p.m.
Rovshan Gurbanov

Сборка под старые версии Android

У меня SDK почти все версии есть, NDK есть версии 10, 17, 21. Но собирается приложение только с NDK v21 под Android версии 7.0 и выше Версия Qt у меня 5.14.2
May 28, 2020, 7:58 a.m.
Evgenij Legotskoj

Освобождение памяти QMainWindow::setCentralWidget

Да, соглашусь. Просто удаление происходит позже, а не сразу.
May 28, 2020, 5:43 a.m.

При подключении к git как указать пароль?

Нужно сделать ssh-keygen и потом полученый из файла код скопировать в ssh ключ в бикбакете
May 28, 2020, 1:42 a.m.


Да, проблема ушла, спасибо.
© EVILEG 2015-2020
Recommend hosting TIMEWEB