Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebindings@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 361 insertions, 0 deletions

diff --git a/python/pyqt/sip/qt/qfiledialog.sip b/python/pyqt/sip/qt/qfiledialog.sip
new file mode 100644
index 00000000..611387a3
--- /dev/null
+++ b/python/pyqt/sip/qt/qfiledialog.sip
@@ -0,0 +1,361 @@
+// 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