qfiledialog.h
This is the verbatim text of the qfiledialog.h include file. It is provided only for illustration; the copyright remains with Trolltech.
/****************************************************************************
** $Id: $
**
** Definition of QFileDialog class
**
** Created : 950428
**
** Copyright (C) 1992-2000 Trolltech AS. All rights reserved.
**
** This file is part of the dialogs module of the Qt GUI Toolkit.
**
** This file may be distributed under the terms of the Q Public License
** as defined by Trolltech AS of Norway and appearing in the file
** LICENSE.QPL included in the packaging of this file.
**
** This file may be distributed and/or modified under the terms of the
** GNU General Public License version 2 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file.
**
** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition
** licenses may use this file in accordance with the Qt Commercial License
** Agreement provided with the Software.
**
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
**
** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
** information about Qt Commercial License Agreements.
** See http://www.trolltech.com/qpl/ for QPL licensing information.
** See http://www.trolltech.com/gpl/ for GPL licensing information.
**
** Contact info@trolltech.com if any conditions of this licensing are
** not clear to you.
**
**********************************************************************/
#ifndef QFILEDIALOG_H
#define QFILEDIALOG_H
class QPushButton;
class QButton;
class QLabel;
class QWidget;
class QFileDialog;
class QTimer;
class QNetworkOperation;
class QLineEdit;
class QListViewItem;
class QListBoxItem;
class QFileDialogPrivate;
class QFileDialogQFileListView;
#ifndef QT_H
#include "qdir.h"
#include "qdialog.h"
#include "qurloperator.h"
#include "qurlinfo.h"
#endif // QT_H
#ifndef QT_NO_FILEDIALOG
class Q_EXPORT QFileIconProvider : public QObject
{
Q_OBJECT
public:
QFileIconProvider( QObject * parent = 0, const char* name = 0 );
virtual const QPixmap * pixmap( const QFileInfo & );
private: // Disabled copy constructor and operator=
#if defined(Q_DISABLE_COPY)
QFileIconProvider( const QFileIconProvider & );
QFileIconProvider& operator=( const QFileIconProvider & );
#endif
};
class Q_EXPORT QFilePreview
{
public:
QFilePreview();
virtual void previewUrl( const QUrl &url ) = 0;
};
class Q_EXPORT QFileDialog : public QDialog
{
Q_OBJECT
Q_ENUMS( Mode ViewMode PreviewMode )
// ##### Why are this read-only properties ?
Q_PROPERTY( QString selectedFile READ selectedFile )
Q_PROPERTY( QString selectedFilter READ selectedFilter )
Q_PROPERTY( QStringList selectedFiles READ selectedFiles )
// #### Should not we be able to set the path ?
Q_PROPERTY( QString dirPath READ dirPath )
Q_PROPERTY( bool showHiddenFiles READ showHiddenFiles WRITE setShowHiddenFiles )
Q_PROPERTY( Mode mode READ mode WRITE setMode )
Q_PROPERTY( ViewMode viewMode READ viewMode WRITE setViewMode )
Q_PROPERTY( PreviewMode previewMode READ previewMode WRITE setPreviewMode )
Q_PROPERTY( bool infoPreview READ isInfoPreviewEnabled WRITE setInfoPreviewEnabled )
Q_PROPERTY( bool contentsPreview READ isContentsPreviewEnabled WRITE setContentsPreviewEnabled )
public:
QFileDialog( const QString& dirName, const QString& filter = QString::null,
QWidget* parent=0, const char* name=0, bool modal = FALSE );
QFileDialog( QWidget* parent=0, const char* name=0, bool modal = FALSE );
~QFileDialog();
// recommended static functions
static QString getOpenFileName( const QString &initially = QString::null,
const QString &filter = QString::null,
QWidget *parent = 0, const char* name = 0,
const QString &caption = QString::null,
QString *selectedFilter = 0,
bool resolveSymlinks = TRUE);
static QString getSaveFileName( const QString &initially = QString::null,
const QString &filter = QString::null,
QWidget *parent = 0, const char* name = 0,
const QString &caption = QString::null,
QString *selectedFilter = 0,
bool resolveSymlinks = TRUE);
static QString getExistingDirectory( const QString &dir = QString::null,
QWidget *parent = 0,
const char* name = 0,
const QString &caption = QString::null,
bool dirOnly = TRUE,
bool resolveSymlinks = TRUE);
static QStringList getOpenFileNames( const QString &filter= QString::null,
const QString &dir = QString::null,
QWidget *parent = 0,
const char* name = 0,
const QString &caption = QString::null,
QString *selectedFilter = 0,
bool resolveSymlinks = TRUE);
// other static functions
static void setIconProvider( QFileIconProvider * );
static QFileIconProvider * iconProvider();
// non-static function for special needs
QString selectedFile() const;
QString selectedFilter() const;
virtual void setSelectedFilter( const QString& );
virtual void setSelectedFilter( int );
void setSelection( const QString &);
void selectAll( bool b );
QStringList selectedFiles() const;
QString dirPath() const;
void setDir( const QDir & );
const QDir *dir() const;
void setShowHiddenFiles( bool s );
bool showHiddenFiles() const;
void rereadDir();
void resortDir();
enum Mode { AnyFile, ExistingFile, Directory, ExistingFiles, DirectoryOnly };
void setMode( Mode );
Mode mode() const;
enum ViewMode { Detail, List };
enum PreviewMode { NoPreview, Contents, Info };
void setViewMode( ViewMode m );
ViewMode viewMode() const;
void setPreviewMode( PreviewMode m );
PreviewMode previewMode() const;
bool eventFilter( QObject *, QEvent * );
bool isInfoPreviewEnabled() const;
bool isContentsPreviewEnabled() const;
void setInfoPreviewEnabled( bool );
void setContentsPreviewEnabled( bool );
void setInfoPreview( QWidget *w, QFilePreview *preview );
void setContentsPreview( QWidget *w, QFilePreview *preview );
QUrl url() const;
void addFilter( const QString &filter );
public slots:
void done( int );
void setDir( const QString& );
void setUrl( const QUrlOperator &url );
void setFilter( const QString& );
void setFilters( const QString& );
void setFilters( const char ** );
void setFilters( const QStringList& );
protected:
void resizeEvent( QResizeEvent * );
void keyPressEvent( QKeyEvent * );
void addWidgets( QLabel *, QWidget *, QPushButton * );
void addToolButton( QButton *b, bool separator = FALSE );
void addLeftWidget( QWidget *w );
void addRightWidget( QWidget *w );
signals:
void fileHighlighted( const QString& );
void fileSelected( const QString& );
void filesSelected( const QStringList& );
void dirEntered( const QString& );
void filterSelected( const QString& );
private slots:
void detailViewSelectionChanged();
void listBoxSelectionChanged();
void changeMode( int );
void fileNameEditReturnPressed();
void stopCopy();
void removeProgressDia();
void fileSelected( int );
void fileHighlighted( int );
void dirSelected( int );
void pathSelected( int );
void updateFileNameEdit( QListViewItem *);
void selectDirectoryOrFile( QListViewItem * );
void popupContextMenu( QListViewItem *, const QPoint &, int );
void popupContextMenu( QListBoxItem *, const QPoint & );
void updateFileNameEdit( QListBoxItem *);
void selectDirectoryOrFile( QListBoxItem * );
void fileNameEditDone();
void okClicked();
void filterClicked(); // not used
void cancelClicked();
void cdUpClicked();
void newFolderClicked();
void fixupNameEdit();
void doMimeTypeLookup();
void updateGeometries();
void modeButtonsDestroyed();
void urlStart( QNetworkOperation *op );
void urlFinished( QNetworkOperation *op );
void dataTransferProgress( int bytesDone, int bytesTotal, QNetworkOperation * );
void insertEntry( const QValueList<QUrlInfo> &fi, QNetworkOperation *op );
void removeEntry( QNetworkOperation * );
void createdDirectory( const QUrlInfo &info, QNetworkOperation * );
void itemChanged( QNetworkOperation * );
void goBack();
private:
enum PopupAction {
PA_Open = 0,
PA_Delete,
PA_Rename,
PA_SortName,
PA_SortSize,
PA_SortType,
PA_SortDate,
PA_SortUnsorted,
PA_Cancel,
PA_Reload,
PA_Hidden
};
void init();
bool trySetSelection( bool isDir, const QUrlOperator &, bool );
void deleteFile( const QString &filename );
void popupContextMenu( const QString &filename, bool withSort,
PopupAction &action, const QPoint &p );
void updatePreviews( const QUrl &u );
QDir reserved; // was cwd
QString fileName;
friend class QFileDialogQFileListView;
friend class QFileListBox;
QFileDialogPrivate *d;
QFileDialogQFileListView *files;
QLineEdit *nameEdit; // also filter
QPushButton *okB;
QPushButton *cancelB;
#if defined(Q_WS_WIN)
static QString winGetOpenFileName( const QString &initialSelection,
const QString &filter,
QString* workingDirectory,
QWidget *parent = 0,
const char* name = 0,
const QString& caption = QString::null,
QString* selectedFilter = 0 );
static QString winGetSaveFileName( const QString &initialSelection,
const QString &filter,
QString* workingDirectory,
QWidget *parent = 0,
const char* name = 0,
const QString& caption = QString::null,
QString* selectedFilter = 0 );
static QStringList winGetOpenFileNames( const QString &filter,
QString* workingDirectory,
QWidget *parent = 0,
const char* name = 0,
const QString& caption = QString::null,
QString* selectedFilter = 0 );
static QString winGetExistingDirectory( const QString &initialDirectory,
QWidget* parent = 0,
const char* name = 0,
const QString& caption = QString::null);
static QString resolveLinkFile( const QString& linkfile );
#endif
#if defined(Q_WS_MACX) || defined(Q_WS_MAC9)
static QString macGetSaveFileName( const QString &, const QString &,
QString *, QWidget *, const char*,
const QString&, QString *);
static QStringList macGetOpenFileNames( const QString &, QString*,
QWidget *, const char *,
const QString&, QString *,
bool = TRUE, bool = FALSE );
#endif
private: // Disabled copy constructor and operator=
#if defined(Q_DISABLE_COPY)
QFileDialog( const QFileDialog & );
QFileDialog &operator=( const QFileDialog & );
#endif
};
#endif
#endif // QFILEDIALOG_H
