src/Qtx/QtxTranslator.cxx

   1 //  Copyright (C) 2007-2008  CEA/DEN, EDF R&D, OPEN CASCADE
   2 //
   3 //  Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
   4 //  CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
   5 //
   6 //  This library is free software; you can redistribute it and/or
   7 //  modify it under the terms of the GNU Lesser General Public
   8 //  License as published by the Free Software Foundation; either
   9 //  version 2.1 of the License.
  10 //
  11 //  This library is distributed in the hope that it will be useful,
  12 //  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 //  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14 //  Lesser General Public License for more details.
  15 //
  16 //  You should have received a copy of the GNU Lesser General Public
  17 //  License along with this library; if not, write to the Free Software
  18 //  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  19 //
  20 //  See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
  21 //
  22 // File:      QtxTranslator.cxx
  23 // Author:    Alexander SOLOVYOV
  24 //
  25 #include "QtxTranslator.h"
  26
  27 /*!
  28   \class QtxTranslator
  29   \brief Extended version of QTranslator
  30
  31   In addition to the functionality provided by QTranslator class, QtxTranslator
  32   allows translating resources defined in the global context (i.e. common resources).
  33   The QtxTranslator can be used to workaround QTranslator's limitation which
  34   does not allow to process messages with global context.
  35
  36   For the current moment global context should be specified in translation
  37   (*.ts/*.qm) files as "@default" string. For example:
  38   \verbatim
  39   <!DOCTYPE TS><TS>
  40   <context>
  41     <name>@default</name>
  42     <message>
  43         <source>MY_MESSAGE</source>
  44         <translation>My translated message</translation>
  45     </message>
  46   </context>
  47   </TS>
  48   \endverbatim
  49 */
  50
  51 #define GLOBAL_CONTEXT "@default"
  52
  53 /*!
  54   \brief Constructor.
  55 */
  56 QtxTranslator::QtxTranslator( QObject* parent )
  57 : QTranslator( parent )
  58 {
  59 }
  60
  61 /*!
  62   \brief Destructor.
  63 */
  64 QtxTranslator::~QtxTranslator()
  65 {
  66 }
  67
  68 /*!
  69   \brief Returns the translation for the key.
  70   \param context message context
  71   \param sourceText message source name
  72   \param comment message comment (optional)
  73   \return Translated text if found or \a sourceText otherwise
  74 */
  75 QString QtxTranslator::translate( const char* context, const char* sourceText, const char* comment ) const
  76 {
  77   QString res = QTranslator::translate( context, sourceText, comment );
  78   if( res.isNull() )
  79     res = QTranslator::translate( GLOBAL_CONTEXT, sourceText, comment );
  80   return res;
  81 }