You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
pytqt/sip/qt/qfiledialog.sip

362 lines
8.6 KiB

// 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