| // SPDX-License-Identifier: LGPL-2.1-or-later | |
| /*************************************************************************** | |
| * Copyright (c) 2004 Werner Mayer <wmayer[at]users.sourceforge.net> * | |
| * * | |
| * This file is part of the FreeCAD CAx development system. * | |
| * * | |
| * This library is free software; you can redistribute it and/or * | |
| * modify it under the terms of the GNU Library General Public * | |
| * License as published by the Free Software Foundation; either * | |
| * version 2 of the License, or (at your option) any later version. * | |
| * * | |
| * This library is distributed in the hope that it will be useful, * | |
| * but WITHOUT ANY WARRANTY; without even the implied warranty of * | |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * | |
| * GNU Library General Public License for more details. * | |
| * * | |
| * You should have received a copy of the GNU Library General Public * | |
| * License along with this library; see the file COPYING.LIB. If not, * | |
| * write to the Free Software Foundation, Inc., 59 Temple Place, * | |
| * Suite 330, Boston, MA 02111-1307, USA * | |
| * * | |
| ***************************************************************************/ | |
| class QDir; | |
| namespace Gui | |
| { | |
| using TStringList = std::list<std::string>; | |
| using TStringMap = std::map<std::string, std::string>; | |
| /** | |
| * The Translator class uses Qt's QTranslator objects to change the language of the application | |
| * on the fly. | |
| * For more details see the \link i18n.html Internationalization with FreeCAD \endlink | |
| * documentation. | |
| * | |
| * \author Werner Mayer | |
| */ | |
| class TranslatorP; | |
| class GuiExport Translator: public QObject | |
| { | |
| Q_OBJECT | |
| public: | |
| class ParameterObserver; | |
| static constexpr std::initializer_list<const char*> formattingOptions { | |
| QT_TR_NOOP("Operating system"), | |
| QT_TR_NOOP("Selected language"), | |
| QT_TR_NOOP("C/POSIX") | |
| }; | |
| /** @name singleton stuff */ | |
| //@{ | |
| /// Creates an instance | |
| static Translator* instance(); | |
| /// Destroys the instance | |
| static void destruct(); | |
| //@} | |
| /** Activates the specified language \a lang if available. */ | |
| void activateLanguage(const char* lang); | |
| /* Reloads the translators */ | |
| void refresh(); | |
| /** Returns the currently installed language. If no language is installed an empty string is | |
| * returned. */ | |
| std::string activeLanguage() const; | |
| /** Returns the locale (e.g. "de") to the given language name. */ | |
| std::string locale(const std::string&) const; | |
| /** Sets default Qt locale based on given language name **/ | |
| void setLocale(const std::string& = "") const; | |
| /** Returns a list of supported languages. */ | |
| TStringList supportedLanguages() const; | |
| /** Returns a map of supported languages/locales. */ | |
| TStringMap supportedLocales() const; | |
| /** Adds a path where localization files can be found */ | |
| void addPath(const QString& path); | |
| /** eventFilter used to convert decimal separator **/ | |
| bool eventFilter(QObject* obj, QEvent* ev) override; | |
| /** Enables/disables decimal separator conversion **/ | |
| void enableDecimalPointConversion(bool on); | |
| /** Returns whether decimal separator conversion is enabled */ | |
| bool isEnabledDecimalPointConversion() const; | |
| private: | |
| Translator(); | |
| ~Translator() override; | |
| void removeTranslators(); | |
| QStringList directories() const; | |
| void installQMFiles(const QDir& dir, const char* locale); | |
| void updateLocaleChange() const; | |
| private: | |
| std::unique_ptr<ParameterObserver> observer; | |
| static Translator* _pcSingleton; | |
| TranslatorP* d; | |
| std::unique_ptr<Translator, std::function<void(Translator*)>> decimalPointConverter; | |
| }; | |
| } // namespace Gui | |