Differential D3800 Diff 9351 src/common/KReportUtils_p.cpp

Changeset View

Standalone View

View Options

src/common/KReportUtils_p.cpp

  • This file was copied from src/common/KReportUtils_p.h.
1/* This file is part of the KDE project 1​/* This file is part of the KDE project
2 Copyright (C) 2015-2016 Jarosław Staniek <staniek@kde.org> 2​ Copyright (C) 2016 Adam Pigg <sadam@piggz.co.uk>
staniekUnsubmitted
Not Done

undo:

  • copyright removal :)
  • typo in email
staniek: undo: - copyright removal :) - typo in email
3 3​
4 This library is free software; you can redistribute it and/or 4​ This library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Library General Public 5​ modify it under the terms of the GNU Library General Public
6 License as published by the Free Software Foundation; either 6​ License as published by the Free Software Foundation; either
7 version 2.1 of the License, or (at your option) any later version. 7​ version 2.1 of the License, or (at your option) any later version.
8 8​
9 This library is distributed in the hope that it will be useful, 9​ This library is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of 10​ but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 11​ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 Library General Public License for more details. 12​ Library General Public License for more details.
13 13​
14 You should have received a copy of the GNU Library General Public License 14​ You should have received a copy of the GNU Library General Public License
15 along with this library; see the file COPYING.LIB. If not, write to 15​ along with this library; see the file COPYING.LIB. If not, write to
16 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, 16​ the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
17 Boston, MA 02110-1301, USA. 17​ Boston, MA 02110-1301, USA.
18*/ 18​*/
19 19​
20#ifndef KREPORTUTILS_P_H 20​#include "KReportUtils_p.h"
21#define KREPORTUTILS_P_H ​
22 21​
23#include <QApplication> 22​#ifdef Q_OS_WIN
23​#define KPATH_SEPARATOR ';'
24​#else
25​#define KPATH_SEPARATOR ':'
26​#endif
24 27​
25#include <KConfigGroup> 28​class KReportDpiSingleton
26#include <KSharedConfig> 29​{
27#include <KMessageBox> 30​public:
31​ KReportDpiSingleton();
28 32​
29#include <QCoreApplication> 33​ int m_dpiX;
30#include <QDir> 34​ int m_dpiY;
31#include <QFileInfo> 35​};
32#include <QRegularExpression> 36​
33#include <QResource> 37​KReportDpiSingleton::KReportDpiSingleton()
34#include <QStandardPaths> 38​{
35#include <QDebug> 39​ // Another way to get the DPI of the display would be QPaintDeviceMetrics,
40​ // but we have no widget here (and moving this to KoView wouldn't allow
41​ // using this from the document easily).
42​#ifdef Q_WS_X11
43​ m_dpiX = QX11Info::appDpiX();
44​ m_dpiY = QX11Info::appDpiY();
45​#else
46​ QDesktopWidget *w = QApplication::desktop();
47​ if (w) {
48​ m_dpiX = w->logicalDpiX();
49​ m_dpiY = w->logicalDpiY();
50​ } else {
51​ m_dpiX = 75;
52​ m_dpiY = 75;
53​ }
54​#endif
55​}
56​
57​Q_GLOBAL_STATIC(KReportDpiSingleton, s_instance)
36 58​
37// This is a private code made inline for use in the lib and examples. ​
38//! @todo Move to a shared lib to use in other Kexi libraries as well. ​
39 59​
40namespace KReportPrivate { ​
41 60​
42//! @todo Support other themes 61​namespace KReportPrivate
43const QString supportedIconTheme = QLatin1String("breeze"); 62​{
44 63​
45//! @brief @return true if @a path is readable ​
46bool fileReadable(const QString &path) 64​bool fileReadable(const QString &path)
47{ 65​{
48 return !path.isEmpty() && QFileInfo(path).isReadable(); 66​ return !path.isEmpty() && QFileInfo(path).isReadable();
49} 67​}
50 68​
51//! @brief Used for a workaround: locations for QStandardPaths::AppDataLocation end with app name. ​
52//! If this is not an expected app but for example a test app, replace ​
53//! the subdir name with app name so we can find resource file(s). ​
54QStringList correctStandardLocations(const QString &privateName, 69​QStringList correctStandardLocations(const QString &privateName,
55 QStandardPaths::StandardLocation location, 70​ QStandardPaths::StandardLocation location,
56 const QString &extraLocation) 71​ const QString &extraLocation)
57{ 72​ {
58 QStringList result; 73​ QStringList result;
59 if (!privateName.isEmpty()) { 74​ if (!privateName.isEmpty()) {
60 QRegularExpression re(QLatin1Char('/') + QCoreApplication::applicationName() + QLatin1Char('$')); 75​ QRegularExpression re(QLatin1Char('/') + QCoreApplication::applicationName() + QLatin1Char('$'));
61 QStringList standardLocations(QStandardPaths::standardLocations(location)); 76​ QStringList standardLocations(QStandardPaths::standardLocations(location));
62 if (!extraLocation.isEmpty()) { 77​ if (!extraLocation.isEmpty()) {
63 standardLocations.append(extraLocation); 78​ standardLocations.append(extraLocation);
64 } 79​ }
65 for(const QString &dir : standardLocations) { 80​ for(const QString &dir : standardLocations) {
66 if (dir.indexOf(re) != -1) { 81​ if (dir.indexOf(re) != -1) {
67 QString realDir(dir); 82​ QString realDir(dir);
68 realDir.replace(re, QLatin1Char('/') + privateName); 83​ realDir.replace(re, QLatin1Char('/') + privateName);
69 result.append(realDir); 84​ result.append(realDir);
70 } 85​ }
71 } 86​ }
72 } 87​ }
73 return result; 88​ return result;
74} 89​}
75 90​
76#ifdef Q_OS_WIN ​
77#define KPATH_SEPARATOR ';' ​
78#else ​
79#define KPATH_SEPARATOR ':' ​
80#endif ​
81 ​
82/*! @brief Locates a file path for specified parameters ​
83 * @param privateName Name to be used instead of application name for resource lookup ​
84 * @param path Relative path to the resource file ​
85 * @param location Standard file location to use for file lookup ​
86 * @param extraLocation Extra directory path for file lookup ​
87 * @return Empty string on failure ​
88 */ ​
89QString locateFile(const QString &privateName, 91​QString locateFile(const QString &privateName,
90 const QString& path, QStandardPaths::StandardLocation location, 92​ const QString& path, QStandardPaths::StandardLocation location,
91 const QString &extraLocation) 93​ const QString &extraLocation)
92{ 94​{
93 // let QStandardPaths handle this, it will look for app local stuff 95​ // let QStandardPaths handle this, it will look for app local stuff
94 QString fullPath = QFileInfo( 96​ QString fullPath = QFileInfo(
95 QStandardPaths::locate(location, path)).canonicalFilePath(); 97​ QStandardPaths::locate(location, path)).canonicalFilePath();
96 if (fileReadable(fullPath)) { 98​ if (fileReadable(fullPath)) {
Show All 19 Lines117 for(const QString &dir : correctedStandardLocations) {
116 fullPath = QFileInfo(dir + QLatin1Char('/') + path).canonicalFilePath(); 118​ fullPath = QFileInfo(dir + QLatin1Char('/') + path).canonicalFilePath();
117 if (fileReadable(fullPath)) { 119​ if (fileReadable(fullPath)) {
118 return fullPath; 120​ return fullPath;
119 } 121​ }
120 } 122​ }
121 return QString(); 123​ return QString();
122} 124​}
123 125​
124/*! @brief Registers icons resource file ​
125 * @param privateName Name to be used instead of application name for resource lookup ​
126 * @param path Relative path to the resource file ​
127 * @param location Standard file location to use for file lookup ​
128 * @param resourceRoot A resource root for QResource::registerResource() ​
129 * @param errorMessage On failure it is set to a brief error message. ​
130 * @param errorDescription On failure it is set to a detailed error message. ​
131 * other for warning ​
132 */ ​
133bool registerIconsResource(const QString &privateName, const QString& path, 126​bool registerIconsResource(const QString &privateName, const QString& path,
134 QStandardPaths::StandardLocation location, 127​ QStandardPaths::StandardLocation location,
135 const QString &resourceRoot, const QString &extraLocation, 128​ const QString &resourceRoot, const QString &extraLocation,
136 QString *errorMessage, QString *detailedErrorMessage) 129​ QString *errorMessage, QString *detailedErrorMessage)
137{ 130​{
138 const QString fullPath = locateFile(privateName, path, location, extraLocation); 131​ const QString fullPath = locateFile(privateName, path, location, extraLocation);
139 if (fullPath.isEmpty() || !QFileInfo(fullPath).isReadable() 132​ if (fullPath.isEmpty() || !QFileInfo(fullPath).isReadable()
140 || !QResource::registerResource(fullPath, resourceRoot)) 133​ || !QResource::registerResource(fullPath, resourceRoot))
Show All 19 Lines
160#endif 153​#endif
161 return false; 154​ return false;
162 } 155​ }
163 *errorMessage = QString(); 156​ *errorMessage = QString();
164 *detailedErrorMessage = QString(); 157​ *detailedErrorMessage = QString();
165 return true; 158​ return true;
166} 159​}
167 160​
168/*! @brief Registers a global icon resource file ​
169 * @param themeName A name of icon theme to use. ​
170 * @param errorMessage On failure it is set to a brief error message. ​
171 * @param errorDescription On failure it is set to a detailed error message. ​
172 * other for warning ​
173 */ ​
174bool registerGlobalIconsResource(const QString &themeName, 161​bool registerGlobalIconsResource(const QString &themeName,
175 QString *errorMessage, 162​ QString *errorMessage,
176 QString *detailedErrorMessage) 163​ QString *detailedErrorMessage)
177{ 164​{
178 QString extraLocation; 165​ QString extraLocation;
179#ifdef CMAKE_INSTALL_FULL_ICONDIR 166​#ifdef CMAKE_INSTALL_FULL_ICONDIR
180 extraLocation = QDir::fromNativeSeparators(QFile::decodeName(CMAKE_INSTALL_FULL_ICONDIR)); 167​ extraLocation = QDir::fromNativeSeparators(QFile::decodeName(CMAKE_INSTALL_FULL_ICONDIR));
181 if (extraLocation.endsWith("/icons")) { 168​ if (extraLocation.endsWith("/icons")) {
182 extraLocation.chop(QLatin1String("/icons").size()); 169​ extraLocation.chop(QLatin1String("/icons").size());
183 } 170​ }
184#elif defined(Q_OS_WIN) 171​#elif defined(Q_OS_WIN)
185 extraLocation = QCoreApplication::applicationDirPath() + QStringLiteral("/data"); 172​ extraLocation = QCoreApplication::applicationDirPath() + QStringLiteral("/data");
186#endif 173​#endif
187 return registerIconsResource(QString(), QString::fromLatin1("icons/%1/%1-icons.rcc").arg(themeName), 174​ return registerIconsResource(QString(), QString::fromLatin1("icons/%1/%1-icons.rcc").arg(themeName),
188 QStandardPaths::GenericDataLocation, 175​ QStandardPaths::GenericDataLocation,
189 QStringLiteral("/icons/") + themeName, 176​ QStringLiteral("/icons/") + themeName,
190 extraLocation, errorMessage, 177​ extraLocation, errorMessage,
191 detailedErrorMessage); 178​ detailedErrorMessage);
192} 179​}
193 180​
194/*! @brief Registers a global icon resource file ​
195 * @param themeName A name of icon theme to use. ​
196 */ ​
197bool registerGlobalIconsResource(const QString &themeName) 181​bool registerGlobalIconsResource(const QString &themeName)
198{ 182​{
199 QString errorMessage; 183​ QString errorMessage;
200 QString detailedErrorMessage; 184​ QString detailedErrorMessage;
201 if (!registerGlobalIconsResource(themeName, &errorMessage, &detailedErrorMessage)) { 185​ if (!registerGlobalIconsResource(themeName, &errorMessage, &detailedErrorMessage)) {
202 if (detailedErrorMessage.isEmpty()) { 186​ if (detailedErrorMessage.isEmpty()) {
203 KMessageBox::error(nullptr, errorMessage); 187​ KMessageBox::error(nullptr, errorMessage);
204 } else { 188​ } else {
205 KMessageBox::detailedError(nullptr, errorMessage, detailedErrorMessage); 189​ KMessageBox::detailedError(nullptr, errorMessage, detailedErrorMessage);
206 } 190​ }
207 qWarning() << qPrintable(errorMessage); 191​ qWarning() << qPrintable(errorMessage);
208 return false; 192​ return false;
209 } 193​ }
210 return true; 194​ return true;
211} 195​}
212 196​
213/*! @brief Registers a global icon resource file for default theme name. ​
214 */ ​
215bool registerGlobalIconsResource() 197​bool registerGlobalIconsResource()
216{ 198​{
217 return registerGlobalIconsResource(supportedIconTheme); 199​ return registerGlobalIconsResource(supportedIconTheme);
218} 200​}
219 201​
220/*! @brief Sets up a private icon resource file ​
221 * @return @c false on failure and sets error message. Does not warn or exit on failure. ​
222 * @param privateName Name to be used instead of application name for resource lookup ​
223 * @param path Relative path to the resource file ​
224 * @param themeName Icon theme to use. It affects filename. ​
225 * @param errorMessage On failure it is set to a brief error message ​
226 * @param errorDescription On failure it is set to a detailed error message ​
227 * other for warning ​
228 * @param prefix Resource path prefix. The default is useful for library-global resource, ​
229 * other values is useful for plugins. ​
230 */ ​
231bool setupPrivateIconsResource(const QString &privateName, const QString& path, 202​bool setupPrivateIconsResource(const QString &privateName, const QString& path,
232 const QString &themeName, 203​ const QString &themeName,
233 QString *errorMessage, QString *detailedErrorMessage, 204​ QString *errorMessage, QString *detailedErrorMessage,
234 const QString &prefix = QLatin1String(":/icons")) 205​ const QString &prefix)
235{ 206​{
236 // Register application's resource first to have priority over the theme. 207​ // Register application's resource first to have priority over the theme.
237 // Some icons may exists in both resources. 208​ // Some icons may exists in both resources.
238 if (!registerIconsResource(privateName, path, 209​ if (!registerIconsResource(privateName, path,
239 QStandardPaths::AppDataLocation, 210​ QStandardPaths::AppDataLocation,
240 QString(), QString(), errorMessage, detailedErrorMessage)) 211​ QString(), QString(), errorMessage, detailedErrorMessage))
241 { 212​ {
242 return false; 213​ return false;
Show All 12 Lines222#endif
255 // tell KIconLoader an co. about the theme 226​ // tell KIconLoader an co. about the theme
256 if (changeTheme) { 227​ if (changeTheme) {
257 cg.writeEntry("Theme", themeName); 228​ cg.writeEntry("Theme", themeName);
258 cg.sync(); 229​ cg.sync();
259 } 230​ }
260 return true; 231​ return true;
261} 232​}
262 233​
263/*! @brief Sets up a private icon resource file ​
264 * @return @c false on failure and sets error message. ​
265 * @param privateName Name to be used instead of application name for resource lookup ​
266 * @param path Relative path to the resource file ​
267 * @param themeName Icon theme to use. It affects filename. ​
268 * @param errorMessage On failure it is set to a brief error message. ​
269 * @param errorDescription On failure it is set to a detailed error message. ​
270 * other for warning ​
271 * @param prefix Resource path prefix. The default is useful for library-global resource, ​
272 * other values is useful for plugins. ​
273 */ ​
274bool setupPrivateIconsResourceWithMessage(const QString &privateName, const QString& path, 234​bool setupPrivateIconsResourceWithMessage(const QString &privateName, const QString& path,
275 const QString &themeName, 235​ const QString &themeName,
276 QString *errorMessage, QString *detailedErrorMessage, 236​ QString *errorMessage, QString *detailedErrorMessage,
277 const QString &prefix = QLatin1String(":/icons")) 237​ const QString &prefix)
278{ 238​{
279 if (!setupPrivateIconsResource(privateName, path, themeName, 239​ if (!setupPrivateIconsResource(privateName, path, themeName,
280 errorMessage, detailedErrorMessage, prefix)) 240​ errorMessage, detailedErrorMessage, prefix))
281 { 241​ {
282 if (detailedErrorMessage->isEmpty()) { 242​ if (detailedErrorMessage->isEmpty()) {
283 KMessageBox::error(nullptr, *errorMessage); 243​ KMessageBox::error(nullptr, *errorMessage);
284 } else { 244​ } else {
285 KMessageBox::detailedError(nullptr, *errorMessage, *detailedErrorMessage); 245​ KMessageBox::detailedError(nullptr, *errorMessage, *detailedErrorMessage);
286 } 246​ }
287 return false; 247​ return false;
288 } 248​ }
289 return true; 249​ return true;
290} 250​}
291 251​
292/*! @overload setupPrivateIconsResourceWithMessage(QString &privateName, const QString& path, ​
293 const QString &themeName, ​
294 QString *errorMessage, QString *detailedErrorMessage, ​
295 const QString &prefix = QLatin1String(":/icons")) ​
296 Uses default theme name. ​
297 */ ​
298bool setupPrivateIconsResourceWithMessage(const QString &privateName, const QString& path, 252​bool setupPrivateIconsResourceWithMessage(const QString &privateName, const QString& path,
299 QString *errorMessage, QString *detailedErrorMessage, 253​ QString *errorMessage, QString *detailedErrorMessage,
300 const QString &prefix = QLatin1String(":/icons")) 254​ const QString &prefix)
301{ 255​{
302 return setupPrivateIconsResourceWithMessage(privateName, path, supportedIconTheme, 256​ return setupPrivateIconsResourceWithMessage(privateName, path, supportedIconTheme,
303 errorMessage, detailedErrorMessage, prefix); 257​ errorMessage, detailedErrorMessage, prefix);
304} 258​}
305 259​
306/*! @brief Sets up a private icon resource file ​
307 * Warns on failure and returns @c false. ​
308 * @param privateName Name to be used instead of application name for resource lookup ​
309 * @param path Relative path to the resource file ​
310 * @param messageType Type of message to use on error, QtFatalMsg for fatal exit and any ​
311 * other for warning ​
312 * @param prefix Resource path prefix. The default is useful for library-global resource, ​
313 * other values is useful for plugins. ​
314 */ ​
315bool setupPrivateIconsResourceWithMessage(const QString &privateName, const QString& path, 260​bool setupPrivateIconsResourceWithMessage(const QString &privateName, const QString& path,
316 QtMsgType messageType, 261​ QtMsgType messageType,
317 const QString &prefix = QLatin1String(":/icons")) 262​ const QString &prefix)
318{ 263​{
319 QString errorMessage; 264​ QString errorMessage;
320 QString detailedErrorMessage; 265​ QString detailedErrorMessage;
321 if (!setupPrivateIconsResourceWithMessage(privateName, path, 266​ if (!setupPrivateIconsResourceWithMessage(privateName, path,
322 &errorMessage, &detailedErrorMessage, prefix)) { 267​ &errorMessage, &detailedErrorMessage, prefix)) {
323 if (messageType == QtFatalMsg) { 268​ if (messageType == QtFatalMsg) {
324 qFatal("%s %s", qPrintable(errorMessage), qPrintable(detailedErrorMessage)); 269​ qFatal("%s %s", qPrintable(errorMessage), qPrintable(detailedErrorMessage));
325 } else { 270​ } else {
326 qWarning() << qPrintable(errorMessage) << qPrintable(detailedErrorMessage); 271​ qWarning() << qPrintable(errorMessage) << qPrintable(detailedErrorMessage);
327 } 272​ }
328 return false; 273​ return false;
329 } 274​ }
330 return true; 275​ return true;
331} 276​}
332 277​
333//! Sets up a global icon theme if it is different from supported. ​
334//! Warns on failure and returns @c false. ​
335bool setupGlobalIconTheme() 278​bool setupGlobalIconTheme()
336{ 279​{
337 if (0 != QIcon::themeName().compare(supportedIconTheme, Qt::CaseInsensitive)) { 280​ if (0 != QIcon::themeName().compare(supportedIconTheme, Qt::CaseInsensitive)) {
338 const QString message = QString::fromLatin1( 281​ const QString message = QString::fromLatin1(
339 "\"%1\" supports only \"%2\" icon theme but current system theme is \"%3\". " 282​ "\"%1\" supports only \"%2\" icon theme but current system theme is \"%3\". "
340 "Application's icon theme will be changed to \"%2\". " 283​ "Application's icon theme will be changed to \"%2\". "
341 "Please consider adding support for other themes to %4.") 284​ "Please consider adding support for other themes to %4.")
342 .arg(QLatin1String(KREPORT_BASE_NAME)).arg(supportedIconTheme).arg(QIcon::themeName()) 285​ .arg(QLatin1String(KREPORT_BASE_NAME)).arg(supportedIconTheme).arg(QIcon::themeName())
343 .arg(QCoreApplication::applicationName()); 286​ .arg(QCoreApplication::applicationName());
344 qDebug() << qPrintable(message); 287​ qDebug() << qPrintable(message);
345 if (!registerGlobalIconsResource()) { 288​ if (!registerGlobalIconsResource()) {
346 // don't fail, just warn 289​ // don't fail, just warn
347 const QString message = QString::fromLatin1( 290​ const QString message = QString::fromLatin1(
348 "Failed to set icon theme to \"%1\". Icons in the application will be inconsistent. " 291​ "Failed to set icon theme to \"%1\". Icons in the application will be inconsistent. "
349 "Please install .rcc file(s) for the system theme.") 292​ "Please install .rcc file(s) for the system theme.")
350 .arg(supportedIconTheme); 293​ .arg(supportedIconTheme);
351 qDebug() << qPrintable(message); 294​ qDebug() << qPrintable(message);
352 return false; 295​ return false;
353 } 296​ }
354 } 297​ }
355 return true; 298​ return true;
356} 299​}
357 300​
358} // KReportPrivate 301​int dpiX()
302​{
303​ return s_instance->m_dpiX;
304​}
359 305​
360#endif 306​int dpiY()
307​{
308​ return s_instance->m_dpiY;
309​}
310​
311​}