// This is the SIP interface definition for QTranslator and QTranslatorMessage.
//
// Copyright (c) 2007
// 	Riverbank Computing Limited <info@riverbankcomputing.co.uk>
// 
// This file is part of PyQt.
// 
// This copy of PyQt is free software; you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by the Free
// Software Foundation; either version 2, or (at your option) any later
// version.
// 
// PyQt is supplied 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 General Public License for more
// details.
// 
// You should have received a copy of the GNU General Public License along with
// PyQt; see the file LICENSE.  If not, write to the Free Software Foundation,
// Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 
 
%ExportedDoc
<Sect2><Title>QTranslator (Qt v2+)</Title>
<Para>
<Literal>QTranslator</Literal> is fully implemented.
</Para>
</Sect2>

<Sect2><Title>QTranslatorMessage (Qt v2.2+)</Title>
<Para>
<Literal>QTranslatorMessage</Literal> is fully implemented.
</Para>
</Sect2>
%End


%If (Qt_2_2_0 -)

class QTranslatorMessage
{
%TypeHeaderCode
#include <qtranslator.h>
%End

public:
	QTranslatorMessage();
	QTranslatorMessage(const char *,const char *,const char *,
			   const QString & = QString::null);
	QTranslatorMessage(QDataStream &);
	QTranslatorMessage(const QTranslatorMessage &);
 
	uint hash() const;
	const char *context() const;
	const char *sourceText() const;
	const char *comment() const;
 
	void setTranslation(const QString &);
	QString translation() const;
 
	enum Prefix {
		NoPrefix,
		Hash,
		HashContext,
		HashContextSourceText,
		HashContextSourceTextComment
	};

%If (- Qt_3_0_0)
	void write(QDataStream &,bool,
		   Prefix = HashContextSourceTextComment) const /ReleaseGIL/;
%End
%If (Qt_3_0_0 -)
	void write(QDataStream &,bool = 0,
		   Prefix = HashContextSourceTextComment) const /ReleaseGIL/;
%End

	Prefix commonPrefix(const QTranslatorMessage &) const;
};

%End


%If (Qt_2_00 -)

class QTranslator : QObject
{
%TypeHeaderCode
#include <qtranslator.h>
%End

public:
%If (Qt_3_2_0 -)
	QTranslator(QObject * /TransferThis/ = 0,const char * = 0);
%End
%If (- Qt_3_2_0)
	QTranslator(QObject * /TransferThis/,const char * = 0);
%End

%If (Qt_2_2_0 -)
	QString find(const char *,const char *,const char *) const;
%End
%If (- Qt_3_0_0)
	virtual QString find(const char *,const char *) const;
%End

%If (Qt_2_2_0 - Qt_3_0_0)
	QTranslatorMessage findMessage(const char *,const char *,
				       const char *) const;
%End
%If (Qt_3_0_0 - Qt_3_2_0)
	virtual QTranslatorMessage findMessage(const char *,const char *,
					       const char *) const;
%End
%If (Qt_3_2_0 -)
	virtual QTranslatorMessage findMessage(const char *,const char *,
					       const char * = 0) const;
%End

	bool load(const QString &,const QString & = QString::null,
		  const QString & = QString::null,
		  const QString & = QString::null);
%If (Qt_3_1_0 -)
	bool load(const uchar *,int);
%End

	void clear();

	enum SaveMode {
		Everything,
		Stripped
	};

	bool save(const QString &,SaveMode = Everything);

%If (Qt_2_2_0 -)
	void insert(const QTranslatorMessage &);
%End
%If (- Qt_3_0_0)
	void insert(const char *,const char *,const QString &);
%End
%If (Qt_2_2_0 -)
	void remove(const QTranslatorMessage &);
%End
%If (- Qt_3_0_0)
	void remove(const char *,const char *);
%End
%If (- Qt_3_0_0)
	bool contains(const char *,const char *) const;
%End
%If (Qt_2_2_0 - Qt_3_0_0)
	bool contains(const char *,const char *,const char *) const;
%End
%If (Qt_3_0_0 -)
	bool contains(const char *,const char *,const char * = 0) const;
%End

%If (- Qt_3_0_0)
	void squeeze();
%End
%If (Qt_2_2_0 - Qt_3_0_0)
	void squeeze(SaveMode);
%End
%If (Qt_3_0_0 -)
	void squeeze(SaveMode = Everything);
%End
	void unsqueeze();

%If (Qt_2_2_0 -)
	QValueList<QTranslatorMessage> messages() const;
%End

private:
	QTranslator(const QTranslator &);
};

%End
