// This is the SIP interface definition for QFileDialog, QFileIconProvider and
// QFilePreview.
//
// 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>QFileDialog</Title>
<Para>
<Literal>QFileDialog</Literal> is fully implemented.
</Para>
</Sect2>

<Sect2><Title>QFileIconProvider</Title>
<Para>
<Literal>QFileIconProvider</Literal> is fully implemented.
</Para>
</Sect2>

<Sect2><Title>QFilePreview</Title>
<Para>
<Literal>QFilePreview</Literal> is fully implemented.  However it cannot be
used from Python in the same way as it is used from C++ because PyQt does not
support multiple inheritance involving more than one wrapped class.  A trick
that seems to work is to use composition rather than inheritance as in the
following code fragment.
</Para>
<ProgramListing>
class FilePreview(QFilePreview):
    pass

class Preview(QLabel):
    def __init__(self, parent=None):
        QLabel.__init__(self, parent)
        self.preview = FilePreview()
        self.preview.previewUrl = self.previewUrl
</ProgramListing>
<Para>
Note that QFilePreview cannot be instantiated directly because it is abstract.
Thanks to Hans-Peter Jansen for this trick.
</Para>
</Sect2>
%End


%If (Qt_FILEDIALOG)

class QFileIconProvider : QObject
{
%TypeHeaderCode
#include <qfiledialog.h>
%End

public:
	QFileIconProvider(QObject * /TransferThis/ = 0,const char * = 0);

	virtual const QPixmap *pixmap(const QFileInfo &);

private:
%If (Qt_2_1_0 -)
	QFileIconProvider(const QFileIconProvider &);
%End
};


%If (Qt_2_1_0 -)
class QFilePreview
{
%TypeHeaderCode
#include <qfiledialog.h>
%End

public:
	QFilePreview();

	virtual void previewUrl(const QUrl &) = 0;
};
%End


class QFileDialog : QDialog
{
%TypeHeaderCode
#include <qfiledialog.h>
%End

public:
%If (- Qt_2_00)
	QFileDialog(const char *,const char * = 0,QWidget * /TransferThis/ = 0,
		    const char * = 0,bool = 0);
%End
%If (Qt_2_00 -)
	QFileDialog(const QString &,const QString & = QString::null,
		    QWidget * /TransferThis/ = 0,const char * = 0,bool = 0);
%End
	QFileDialog(QWidget * /TransferThis/ = 0,const char * = 0,bool = 0);

%If (- Qt_2_00)
	static QString getOpenFileName(const char * = 0,const char * = 0,
				       QWidget * = 0,
				       const char * = 0) /ReleaseGIL/;
	static QString getSaveFileName(const char * = 0,const char * = 0,
				       QWidget * = 0,
				       const char * = 0) /ReleaseGIL/;
	static QString getExistingDirectory(const char * = 0,QWidget * = 0,
					    const char * = 0) /ReleaseGIL/;
	static QStrList getOpenFileNames(const char * = 0,const char * = 0,
					 QWidget * = 0,
					 const char * = 0) /ReleaseGIL/;
%End
%If (Qt_2_00 - Qt_3_0_0)
	static QString getOpenFileName(const QString & = QString::null,
				       const QString & = QString::null,
				       QWidget * = 0,
				       const char * = 0) /ReleaseGIL/;
	static QString getSaveFileName(const QString & = QString::null,
				       const QString & = QString::null,
				       QWidget * = 0,
				       const char * = 0) /ReleaseGIL/;
	static QString getExistingDirectory(const QString & = QString::null,
					    QWidget * = 0,
					    const char * = 0) /ReleaseGIL/;
	static QStringList getOpenFileNames(const QString & = QString::null,
					    const QString & = QString::null,
					    QWidget * = 0,
					    const char * = 0) /ReleaseGIL/;
%End
%If (Qt_2_1_0 - Qt_3_0_0)
	static QString getOpenFileName(const QString &,const QString &,
				       QWidget *,const char *,
				       const QString &) /ReleaseGIL/;
	static QString getSaveFileName(const QString &,const QString &,
				       QWidget *,const char *,
				       const QString &) /ReleaseGIL/;
	static QString getExistingDirectory(const QString &,QWidget *,
					    const char *,
					    const QString &) /ReleaseGIL/;
	static QStringList getOpenFileNames(const QString &,const QString &,
					   QWidget *,const char *,
					   const QString &) /ReleaseGIL/;
%End
%If (Qt_2_2_0 - Qt_3_0_0)
	static QString getExistingDirectory(const QString &,QWidget *,
					    const char *,
					    const QString &,bool) /ReleaseGIL/;
%End
%If (Qt_3_0_0 -)
	static QString getOpenFileName(const QString & = QString::null,
				       const QString & = QString::null,
				       QWidget * = 0,const char * = 0,
				       const QString & = QString::null,
				       QString * = 0,bool = 1) /ReleaseGIL/;

	static QString getSaveFileName(const QString & = QString::null,
				       const QString & = QString::null,
				       QWidget * = 0,const char * = 0,
				       const QString & = QString::null,
				       QString * = 0,bool = 1) /ReleaseGIL/;

	static QString getExistingDirectory(const QString & = QString::null,
					    QWidget * = 0,const char * = 0,
					    const QString & = QString::null,
					    bool = 1,bool = 1) /ReleaseGIL/;

	static QStringList getOpenFileNames(const QString & = QString::null,
					    const QString & = QString::null,
					    QWidget * = 0,const char * = 0,
					    const QString & = QString::null,
					    QString * = 0,
					    bool = 1) /ReleaseGIL/;

%End

	static void setIconProvider(QFileIconProvider *);
	static QFileIconProvider *iconProvider();

	QString selectedFile() const;
%If (Qt_2_1_0 -)
	QString selectedFilter() const;
%End
%If (Qt_3_0_0 -)
	virtual void setSelectedFilter(const QString &);
	virtual void setSelectedFilter(int);
%End

%If (- Qt_2_00)
	void setSelection(const char *);
%End
%If (Qt_2_00 -)
	void setSelection(const QString &);
%End

%If (Qt_2_1_0 -)
	void selectAll(bool);

	QStringList selectedFiles() const;
%End

%If (- Qt_2_00)
	const char *dirPath() const;
%End
%If (Qt_2_00 -)
	QString dirPath() const;
%End

	void setDir(const QDir &);
	const QDir* dir() const;

%If (Qt_2_1_0 -)
	void setShowHiddenFiles(bool);
	bool showHiddenFiles() const;
%End

	void rereadDir() /ReleaseGIL/;
%If (Qt_2_1_0 -)
	void resortDir();
%End

%If (- Qt_2_2_0)
	enum Mode {
		AnyFile,
		ExistingFile,
		Directory,
		ExistingFiles
	};
%End
%If (Qt_2_2_0 -)
	enum Mode {
		AnyFile,
		ExistingFile,
		Directory,
		ExistingFiles,
		DirectoryOnly
	};
%End

	void setMode(Mode);
	Mode mode() const;

%If (Qt_2_1_0 -)
	enum ViewMode {
		Detail,
		List
	};

	enum PreviewMode {
		NoPreview,
		Contents,
		Info
	};

	void setViewMode(ViewMode);
	ViewMode viewMode() const;
	void setPreviewMode(PreviewMode);
	PreviewMode previewMode() const;
%End

	bool eventFilter(QObject *,QEvent *);

%If (Qt_2_1_0 -)
	bool isInfoPreviewEnabled() const;
	bool isContentsPreviewEnabled() const;
	void setInfoPreviewEnabled(bool);
	void setContentsPreviewEnabled(bool);

	void setInfoPreview(QWidget *,QFilePreview *);
	void setContentsPreview(QWidget *,QFilePreview *);

	QUrl url() const;
%End

%If (Qt_3_0_0 -)
	void addFilter(const QString &);
%End

public slots:
%If (Qt_2_2_0 -)
	void done(int);
%End
%If (- Qt_2_00)
	void setDir(const char *);
%End
%If (Qt_2_00 -)
	void setDir(const QString &);
%End
%If (Qt_2_1_0 -)
	void setUrl(const QUrlOperator &);
%End
%If (- Qt_2_00)
	void setFilter(const char *);
%End
%If (Qt_2_00 -)
	void setFilter(const QString &);
%End
%If (Qt_2_1_0 -)
	void setFilters(const QString &);
%End
//	void setFilters(const char **);
%If (- Qt_2_00)
	void setFilters(const QStrList &);
%End
%If (Qt_2_00 -)
	void setFilters(const QStringList &);
%End

signals:
%If (- Qt_2_00)
	void fileHighlighted(const char *);
	void fileSelected(const char *);
	void dirEntered(const char *);
%End
%If (Qt_2_00 -)
	void fileHighlighted(const QString &);
	void fileSelected(const QString &);
%End
%If (Qt_3_0_0 -)
	void filesSelected(const QStringList &);
%End
%If (Qt_2_00 -)
	void dirEntered(const QString &);
%End
%If (Qt_3_0_0 -)
	void filterSelected(const QString &);
%End

protected:
	void resizeEvent(QResizeEvent *);
	void keyPressEvent(QKeyEvent *);

	void addWidgets(QLabel *,QWidget *,QPushButton *);
%If (Qt_2_1_0 -)
	void addToolButton(QButton *,bool = 0);
	void addLeftWidget(QWidget *);
	void addRightWidget(QWidget *);
%End
%If (Qt_2_1_0 - Qt_3_0_0)
	void addFilter(const QString &);
%End

private:
	QFileDialog(const QFileDialog &);
};

%End
