src/frontends/qt4/qt_helpers.h

   1 // -*- C++ -*-
   2 /**
   3  * \file qt_helpers.h
   4  * This file is part of LyX, the document processor.
   5  * Licence details can be found in the file COPYING.
   6  *
   7  * \author Dekel Tsur
   8  *
   9  * Full author contact details are available in file CREDITS.
  10  */
  11
  12 #ifndef QTHELPERS_H
  13 #define QTHELPERS_H
  14
  15 #include "lyxlength.h"
  16 #include "support/docstring.h"
  17
  18 #include <QChar>
  19 #include <QString>
  20
  21 #include <vector>
  22 #include <utility>
  23 #include <boost/assert.hpp>
  24
  25 class QComboBox;
  26 class QLineEdit;
  27
  28 class LengthCombo;
  29
  30 namespace lyx {
  31
  32 std::string makeFontName(std::string const & family, std::string const & foundry);
  33
  34 std::pair<std::string,std::string> parseFontName(std::string const & name);
  35
  36 /// method to get a LyXLength from widgets (LengthCombo)
  37 std::string widgetsToLength(QLineEdit const * input, LengthCombo const * combo);
  38 /// method to get a LyXLength from widgets (QComboBox)
  39 LyXLength widgetsToLength(QLineEdit const * input, QComboBox const * combo);
  40
  41 /// method to set widgets from a LyXLength
  42 void lengthToWidgets(QLineEdit * input, LengthCombo * combo,
  43         std::string const & len, LyXLength::UNIT default_unit);
  44
  45 /// format a string to the given width
  46 docstring const formatted(docstring const & text, int w = 80);
  47
  48 /**
  49  * toqstr - convert char * into Qt's unicode (UTF16)
  50  *
  51  * Use this whenever there's a user-visible string that is encoded
  52  * for the locale (menus, dialogs etc.)
  53  */
  54 inline QString const toqstr(char const * str)
  55 {
  56         return QString::fromUtf8(str);
  57 }
  58
  59
  60 /**
  61  * toqstr - convert string into unicode
  62  *
  63  * Use this whenever there's a user-visible string that is encoded
  64  * for the locale (menus, dialogs etc.)
  65  */
  66 inline QString const toqstr(std::string const & str)
  67 {
  68         return toqstr(str.c_str());
  69 }
  70
  71
  72 /**
  73  * toqstr - convert ucs4 into QString
  74  *
  75  * QString uses utf16 internally.
  76  */
  77 inline char_type const qchar_to_ucs4(QChar const & qchar) {
  78         return static_cast<char_type>(qchar.unicode());
  79 }
  80
  81 inline QChar const ucs4_to_qchar(char_type const ucs4) {
  82         // FIXME: The following cast is not a real conversion but it work
  83         // for the ucs2 subrange of unicode. Instead of an assertion we should
  84         // return some special characters that indicates that its display is
  85         // not supported.
  86         BOOST_ASSERT(ucs4 < 65536);
  87         return QChar(static_cast<unsigned short>(ucs4));
  88 }
  89
  90 QString const toqstr(docstring const & ucs4);
  91
  92 void ucs4_to_qstring(docstring const & str, QString & s);
  93
  94 inline void ucs4_to_qstring(char_type const * str, size_t ls, QString & s)
  95 {
  96         int i = static_cast<int>(ls);
  97         s.resize(i);
  98         for (; --i >= 0;)
  99                 s[i] = ucs4_to_qchar(str[i]);
 100 }
 101
 102
 103 docstring const qstring_to_ucs4(QString const & qstr);
 104
 105
 106 /**
 107  * qt_ - i18nize string and convert to unicode
 108  *
 109  * Use this in qt4/ instead of qt_()
 110  */
 111 QString const qt_(char const * str, const char * comment);
 112
 113
 114 /**
 115  * qt_ - i18nize string and convert to unicode
 116  *
 117  * Use this in qt4/ instead of qt_()
 118  */
 119 QString const qt_(std::string const & str);
 120
 121
 122 /**
 123  * fromqstr - convert QString into std::string in locale
 124  *
 125  * Return the QString encoded in the locale
 126  */
 127 std::string const fromqstr(QString const & str);
 128
 129
 130 } // namespace lyx
 131
 132 #endif // QTHELPERS_H