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