File indexing completed on 2024-04-21 14:55:45
0001 /* 0002 Copyright (C) 2008 Chusslove Illich <caslav.ilic@gmx.net> 0003 0004 This library is free software; you can redistribute it and/or 0005 modify it under the terms of the GNU Library General Public 0006 License as published by the Free Software Foundation; either 0007 version 2 of the License, or (at your option) any later version. 0008 0009 This library is distributed in the hope that it will be useful, 0010 but WITHOUT ANY WARRANTY; without even the implied warranty of 0011 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 0012 Library General Public License for more details. 0013 0014 You should have received a copy of the GNU Library General Public License 0015 along with this library; see the file COPYING.LIB. If not, write to 0016 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, 0017 Boston, MA 02110-1301, USA. 0018 */ 0019 #ifndef FONTHELPERS_P_H 0020 #define FONTHELPERS_P_H 0021 0022 // i18n-related helpers for fonts, common to KFont* widgets. 0023 0024 #include <QString> 0025 #include <QStringList> 0026 #include <QHash> 0027 0028 // This also exists in KWidgetsAddons -> remove ? 0029 0030 /** 0031 * @internal 0032 * 0033 * Split the compound raw font name into family and foundry. 0034 * 0035 * @param name the raw font name reported by Qt 0036 * @param family the storage for family name 0037 * @param foundry the storage for foundry name 0038 */ 0039 static void splitFontString(const QString &name, 0040 QString *family, QString *foundry = nullptr); 0041 0042 /** 0043 * @internal 0044 * 0045 * Translate the font name for the user. 0046 * Primarily for generic fonts like Serif, Sans-Serif, etc. 0047 * 0048 * @param name the raw font name reported by Qt 0049 * @return translated font name 0050 */ 0051 static QString translateFontName(const QString &name); 0052 0053 /** 0054 * @internal 0055 * 0056 * Compose locale-aware sorted list of translated font names, 0057 * with generic fonts handled in a special way. 0058 * The mapping of translated to raw names can be reported too if required. 0059 * 0060 * @param names raw font names as reported by Qt 0061 * @param trToRawNames storage for mapping of translated to raw names 0062 * @return sorted list of translated font names 0063 */ 0064 static QStringList translateFontNameList(const QStringList &names, 0065 QHash<QString, QString> *trToRawNames = nullptr); 0066 0067 # endif