Qt Utilities 6.14.0
Common Qt related C++ classes and routines used by my applications such as dialogs, widgets and models
Loading...
Searching...
No Matches
resources.h
Go to the documentation of this file.
1#ifndef APPLICATION_UTILITIES_RESOURCES_H
2#define APPLICATION_UTILITIES_RESOURCES_H
3
4#include "../global.h"
5
6#include <QString>
7#include <QtContainerFwd>
8#include <QtGlobal>
9
10#include <initializer_list>
11#include <memory>
12
13QT_FORWARD_DECLARE_CLASS(QString)
14QT_FORWARD_DECLARE_CLASS(QSettings)
15#if (QT_VERSION < QT_VERSION_CHECK(6, 0, 0))
16QT_FORWARD_DECLARE_CLASS(QStringList)
17#endif
18
24#define SET_QT_APPLICATION_INFO \
25 QCoreApplication::setOrganizationName(QStringLiteral(APP_AUTHOR)); \
26 QCoreApplication::setOrganizationDomain(QStringLiteral(APP_DOMAIN)); \
27 QCoreApplication::setApplicationName(QStringLiteral(APP_NAME)); \
28 QCoreApplication::setApplicationVersion(QStringLiteral(APP_VERSION)); \
29 ::QtUtilities::setupCommonQtApplicationAttributes()
30
34#define LOAD_QT_TRANSLATIONS \
35 QtUtilities::TranslationFiles::loadQtTranslationFile(QT_TRANSLATION_FILES); \
36 QtUtilities::TranslationFiles::loadApplicationTranslationFile(QStringLiteral(PROJECT_CONFIG_NAME), APP_SPECIFIC_QT_TRANSLATION_FILES)
37
38namespace QtUtilities {
39
40namespace QtUtilitiesResources {
41
44} // namespace QtUtilitiesResources
45
46namespace TranslationFiles {
47
49QT_UTILITIES_EXPORT void loadQtTranslationFile(std::initializer_list<QString> repositoryNames);
50QT_UTILITIES_EXPORT void loadQtTranslationFile(std::initializer_list<QString> repositoryNames, const QString &localeName);
51QT_UTILITIES_EXPORT void loadApplicationTranslationFile(const QString &configName, const QString &applicationName);
52QT_UTILITIES_EXPORT void loadApplicationTranslationFile(const QString &configName, const QString &applicationName, const QString &localeName);
53QT_UTILITIES_EXPORT void loadApplicationTranslationFile(const QString &configName, const std::initializer_list<QString> &applicationNames);
55 const QString &configName, const std::initializer_list<QString> &applicationNames, const QString &localeName);
57} // namespace TranslationFiles
58
59namespace ApplicationInstances {
60
61#if defined(QT_UTILITIES_GUI_QTWIDGETS)
62QT_UTILITIES_EXPORT bool hasWidgetsApp();
63#endif
64#if defined(QT_UTILITIES_GUI_QTWIDGETS) || defined(QT_UTILITIES_GUI_QTQUICK)
65QT_UTILITIES_EXPORT bool hasGuiApp();
66#endif
68} // namespace ApplicationInstances
69
71QT_UTILITIES_EXPORT std::unique_ptr<QSettings> getSettings(const QString &organization, const QString &application = QString());
72QT_UTILITIES_EXPORT QString errorMessageForSettings(const QSettings &settings);
73
74} // namespace QtUtilities
75
76#endif // APPLICATION_UTILITIES_RESOURCES_H
#define QT_UTILITIES_EXPORT
Marks the symbol to be exported by the qtutilities library.
Definition global.h:14
QT_UTILITIES_EXPORT bool hasCoreApp()
Returns whether a QCoreApplication has been instantiated yet.
QT_UTILITIES_EXPORT void init()
Initiates the resources used and provided by this library.
Definition resources.cpp:51
QT_UTILITIES_EXPORT void cleanup()
Frees the resources used and provided by this library.
Definition resources.cpp:60
QT_UTILITIES_EXPORT void loadQtTranslationFile(std::initializer_list< QString > repositoryNames)
Loads and installs the appropriate Qt translation file for the current locale.
QT_UTILITIES_EXPORT void clearTranslationFiles()
Clears all translation files previously loaded via the load-functions in this namespace.
QT_UTILITIES_EXPORT void loadApplicationTranslationFile(const QString &configName, const QString &applicationName)
Loads and installs the appropriate application translation file for the current locale.
QT_UTILITIES_EXPORT QString & additionalTranslationFilePath()
Allows to set an additional search path for translation files.
Definition resources.cpp:80
QT_UTILITIES_EXPORT std::unique_ptr< QSettings > getSettings(const QString &organization, const QString &application=QString())
Returns the settings object for the specified organization and application.
QT_UTILITIES_EXPORT void setupCommonQtApplicationAttributes()
Sets Qt application attributes which are commonly used within my Qt applications.
QT_UTILITIES_EXPORT QString errorMessageForSettings(const QSettings &settings)
Returns an error message for the specified settings or an empty string if there's no error.