qtranslator.h [include/QtCore/qtranslator.h]

1	/****************************************************************************
2	**
3	** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
4	** Contact: http://www.qt-project.org/
5	**
6	** This file is part of the QtCore module of the Qt Toolkit.
7	**
8	** $QT_BEGIN_LICENSE:LGPL$
9	** GNU Lesser General Public License Usage
10	** This file may be used under the terms of the GNU Lesser General Public
11	** License version 2.1 as published by the Free Software Foundation and
12	** appearing in the file LICENSE.LGPL included in the packaging of this
13	** file. Please review the following information to ensure the GNU Lesser
14	** General Public License version 2.1 requirements will be met:
15	** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
16	**
17	** In addition, as a special exception, Nokia gives you certain additional
18	** rights. These rights are described in the Nokia Qt LGPL Exception
19	** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
20	**
21	** GNU General Public License Usage
22	** Alternatively, this file may be used under the terms of the GNU General
23	** Public License version 3.0 as published by the Free Software Foundation
24	** and appearing in the file LICENSE.GPL included in the packaging of this
25	** file. Please review the following information to ensure the GNU General
26	** Public License version 3.0 requirements will be met:
27	** http://www.gnu.org/copyleft/gpl.html.
28	**
29	** Other Usage
30	** Alternatively, this file may be used in accordance with the terms and
31	** conditions contained in a signed written agreement between you and Nokia.
32	**
33	**
34	**
35	**
36	**
37	**
38	** $QT_END_LICENSE$
39	**
40	****************************************************************************/
41
42	#ifndef QTRANSLATOR_H
43	#define QTRANSLATOR_H
44
45	#include <QtCore/qobject.h>
46	#include <QtCore/qbytearray.h>
47
48	QT_BEGIN_HEADER
49
50	QT_BEGIN_NAMESPACE
51
52	QT_MODULE(Core)
53
54	#ifndef QT_NO_TRANSLATION
55
56	class QLocale;
57	class QTranslatorPrivate;
58
59	class Q_CORE_EXPORT QTranslator : public QObject
60	{
61	Q_OBJECT
62	public:
63	explicit QTranslator(QObject *parent = `0`);
64	#ifdef QT3_SUPPORT
65	QT3_SUPPORT_CONSTRUCTOR QTranslator(QObject * parent, const char * name);
66	#endif
67	~QTranslator();
68
69	// ### Qt 5: Merge (with "int n = -1")
70	virtual QString translate(const char context, const* char *sourceText,
71	const char disambiguation = `0`) const*;
72	QString translate(const char context, const* char sourceText, const* char *disambiguation,
73	int n) const;
74
75	virtual bool isEmpty() const;
76
77	bool load(const QString & filename,
78	const QString & directory = QString(),
79	const QString & search_delimiters = QString(),
80	const QString & suffix = QString());
81	bool load(const QLocale & locale,
82	const QString & filename,
83	const QString & prefix = QString(),
84	const QString & directory = QString(),
85	const QString & suffix = QString());
86	bool load(const uchar data, int* len);
87
88	#ifdef QT3_SUPPORT
89	QT3_SUPPORT QString find(const char context, const* char sourceText, const* char * comment = `0`) const
90	{ return translate(context, sourceText, comment); }
91	#endif
92
93	private:
94	Q_DISABLE_COPY(QTranslator)
95	Q_DECLARE_PRIVATE(QTranslator)
96	};
97
98	#endif // QT_NO_TRANSLATION
99
100	QT_END_NAMESPACE
101
102	QT_END_HEADER
103
104	#endif // QTRANSLATOR_H
105