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.
tqtinterface/qtinterface/qt4/Qt/q3filedialog.h

347 lines
12 KiB

/****************************************************************************
**
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the Qt3Support module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** Commercial Usage
** Licensees holding valid Qt Commercial licenses may use this file in
** accordance with the Qt Commercial License Agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Nokia.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights. These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3.0 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file. Please review the following information to
** ensure the GNU General Public License version 3.0 requirements will be
** met: http://www.gnu.org/copyleft/gpl.html.
**
** If you have questions regarding the use of this file, please contact
** Nokia at qt-info@nokia.com.
** $QT_END_LICENSE$
**
****************************************************************************/
#ifndef Q3FILEDIALOG_H
#define Q3FILEDIALOG_H
#include <QtCore/qdir.h>
#include <QtGui/qdialog.h>
#include <Qt3Support/q3urloperator.h>
#include <Qt3Support/q3valuelist.h>
QT_BEGIN_HEADER
QT_BEGIN_NAMESPACE
QT_MODULE(Qt3SupportLight)
class QAbstractButton;
class QPushButton;
class QLabel;
class QWidget;
class QFileDialog;
class QTimer;
class Q3NetworkOperation;
class QLineEdit;
class Q3ListViewItem;
class Q3ListBoxItem;
class Q3FileDialogPrivate;
class Q3FileDialogQFileListView;
class QUrlInfo;
#ifndef QT_NO_FILEDIALOG
class Q_COMPAT_EXPORT Q3FileIconProvider : public QObject
{
Q_OBJECT
public:
Q3FileIconProvider(QObject * parent = 0, const char* name = 0);
virtual const QPixmap * pixmap(const QFileInfo &);
private:
Q_DISABLE_COPY(Q3FileIconProvider)
};
class Q_COMPAT_EXPORT Q3FilePreview
{
public:
Q3FilePreview();
virtual ~Q3FilePreview() {}
virtual void previewUrl(const Q3Url &url) = 0;
};
class Q_COMPAT_EXPORT Q3FileDialog : 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:
Q3FileDialog(const QString& dirName, const QString& filter = QString(),
QWidget* parent=0, const char* name=0, bool modal = false);
Q3FileDialog(QWidget* parent=0, const char* name=0, bool modal = false);
~Q3FileDialog();
// recommended static functions
static QString getOpenFileName(const QString &initially = QString(),
const QString &filter = QString(),
QWidget *parent = 0, const char* name = 0,
const QString &caption = QString(),
QString *selectedFilter = 0,
bool resolveSymlinks = true);
static QString getSaveFileName(const QString &initially = QString(),
const QString &filter = QString(),
QWidget *parent = 0, const char* name = 0,
const QString &caption = QString(),
QString *selectedFilter = 0,
bool resolveSymlinks = true);
static QString getExistingDirectory(const QString &dir = QString(),
QWidget *parent = 0,
const char* name = 0,
const QString &caption = QString(),
bool dirOnly = true,
bool resolveSymlinks = true);
static QStringList getOpenFileNames(const QString &filter= QString(),
const QString &dir = QString(),
QWidget *parent = 0,
const char* name = 0,
const QString &caption = QString(),
QString *selectedFilter = 0,
bool resolveSymlinks = true);
// other static functions
static void setIconProvider(Q3FileIconProvider *);
static Q3FileIconProvider * 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, Q3FilePreview *preview);
void setContentsPreview(QWidget *w, Q3FilePreview *preview);
Q3Url url() const;
void addFilter(const QString &filter);
public Q_SLOTS:
void done(int);
void setDir(const QString&);
void setUrl(const Q3UrlOperator &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(QAbstractButton *b, bool separator = false);
void addLeftWidget(QWidget *w);
void addRightWidget(QWidget *w);
Q_SIGNALS:
void fileHighlighted(const QString&);
void fileSelected(const QString&);
void filesSelected(const QStringList&);
void dirEntered(const QString&);
void filterSelected(const QString&);
private Q_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(Q3ListViewItem *);
void selectDirectoryOrFile(Q3ListViewItem *);
void popupContextMenu(Q3ListViewItem *, const QPoint &, int);
void popupContextMenu(Q3ListBoxItem *, const QPoint &);
void updateFileNameEdit(Q3ListBoxItem *);
void selectDirectoryOrFile(Q3ListBoxItem *);
void fileNameEditDone();
void okClicked();
void filterClicked(); // not used
void cancelClicked();
void cdUpClicked();
void newFolderClicked();
void fixupNameEdit();
void doMimeTypeLookup();
void updateGeometries();
void modeButtonsDestroyed();
void urlStart(Q3NetworkOperation *op);
void urlFinished(Q3NetworkOperation *op);
void dataTransferProgress(int bytesDone, int bytesTotal, Q3NetworkOperation *);
void insertEntry(const Q3ValueList<QUrlInfo> &fi, Q3NetworkOperation *op);
void removeEntry(Q3NetworkOperation *);
void createdDirectory(const QUrlInfo &info, Q3NetworkOperation *);
void itemChanged(Q3NetworkOperation *);
void goBack();
private:
Q_DISABLE_COPY(Q3FileDialog)
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 Q3UrlOperator &, bool);
void deleteFile(const QString &filename);
void popupContextMenu(const QString &filename, bool withSort,
PopupAction &action, const QPoint &p);
void updatePreviews(const Q3Url &u);
QString fileName;
friend class Q3FileDialogQFileListView;
friend class QFileListBox;
Q3FileDialogPrivate *d;
Q3FileDialogQFileListView *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(),
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(),
QString* selectedFilter = 0);
static QStringList winGetOpenFileNames(const QString &filter,
QString* workingDirectory,
QWidget *parent = 0,
const char* name = 0,
const QString& caption = QString(),
QString* selectedFilter = 0);
static QString winGetExistingDirectory(const QString &initialDirectory,
QWidget* parent = 0,
const char* name = 0,
const QString& caption = QString());
static QString resolveLinkFile(const QString& linkfile);
int old_qt_ntfs_permission_lookup;
#endif
#if defined(Q_WS_MAC)
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
};
#endif // QT_NO_FILEDIALOG
QT_END_NAMESPACE
QT_END_HEADER
#endif // Q3FILEDIALOG_H