1 /****************************************************************************

     2 **

     3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

     4 ** All rights reserved.

     5 ** Contact: Nokia Corporation (qt-info@nokia.com)

     6 **

     7 ** This file is part of the Qt3Support module of the Qt Toolkit.

     8 **

     9 ** $QT_BEGIN_LICENSE:LGPL$

    10 ** No Commercial Usage

    11 ** This file contains pre-release code and may not be distributed.

    12 ** You may use this file in accordance with the terms and conditions

    13 ** contained in the Technology Preview License Agreement accompanying

    14 ** this package.

    15 **

    16 ** GNU Lesser General Public License Usage

    17 ** Alternatively, this file may be used under the terms of the GNU Lesser

    18 ** General Public License version 2.1 as published by the Free Software

    19 ** Foundation and appearing in the file LICENSE.LGPL included in the

    20 ** packaging of this file.  Please review the following information to

    21 ** ensure the GNU Lesser General Public License version 2.1 requirements

    22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

    23 **

    24 ** In addition, as a special exception, Nokia gives you certain additional

    25 ** rights.  These rights are described in the Nokia Qt LGPL Exception

    26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

    27 **

    28 ** If you have questions regarding the use of this file, please contact

    29 ** Nokia at qt-info@nokia.com.

    30 **

    31 **

    32 **

    33 **

    34 **

    35 **

    36 **

    37 **

    38 ** $QT_END_LICENSE$

    39 **

    40 ****************************************************************************/

    41 

    42 #ifndef Q3FILEDIALOG_H

    43 #define Q3FILEDIALOG_H

    44 

    45 #include <QtCore/qdir.h>

    46 #include <QtGui/qdialog.h>

    47 #include <Qt3Support/q3urloperator.h>

    48 #include <Qt3Support/q3valuelist.h>

    49 

    50 QT_BEGIN_HEADER

    51 

    52 QT_BEGIN_NAMESPACE

    53 

    54 QT_MODULE(Qt3SupportLight)

    55 

    56 class QAbstractButton;

    57 class QPushButton;

    58 class QLabel;

    59 class QWidget;

    60 class QFileDialog;

    61 class QTimer;

    62 class Q3NetworkOperation;

    63 class QLineEdit;

    64 class Q3ListViewItem;

    65 class Q3ListBoxItem;

    66 class Q3FileDialogPrivate;

    67 class Q3FileDialogQFileListView;

    68 class QUrlInfo;

    69 

    70 #ifndef QT_NO_FILEDIALOG

    71 

    72 #ifndef QT_MAC_USE_COCOA

    73 

    74 class Q_COMPAT_EXPORT Q3FileIconProvider : public QObject

    75 {

    76     Q_OBJECT

    77 public:

    78     Q3FileIconProvider(QObject * parent = 0, const char* name = 0);

    79     virtual const QPixmap * pixmap(const QFileInfo &);

    80 

    81 private:

    82     Q_DISABLE_COPY(Q3FileIconProvider)

    83 };

    84 

    85 class Q_COMPAT_EXPORT Q3FilePreview

    86 {

    87 public:

    88     Q3FilePreview();

    89     virtual ~Q3FilePreview() {}

    90     virtual void previewUrl(const Q3Url &url) = 0;

    91 

    92 };

    93 

    94 class Q_COMPAT_EXPORT Q3FileDialog : public QDialog

    95 {

    96     Q_OBJECT

    97     Q_ENUMS(Mode ViewMode PreviewMode)

    98     // ##### Why are this read-only properties ?

    99     Q_PROPERTY(QString selectedFile READ selectedFile)

   100     Q_PROPERTY(QString selectedFilter READ selectedFilter)

   101     Q_PROPERTY(QStringList selectedFiles READ selectedFiles)

   102     // #### Should not we be able to set the path ?

   103     Q_PROPERTY(QString dirPath READ dirPath)

   104     Q_PROPERTY(bool showHiddenFiles READ showHiddenFiles WRITE setShowHiddenFiles)

   105     Q_PROPERTY(Mode mode READ mode WRITE setMode)

   106     Q_PROPERTY(ViewMode viewMode READ viewMode WRITE setViewMode)

   107     Q_PROPERTY(PreviewMode previewMode READ previewMode WRITE setPreviewMode)

   108     Q_PROPERTY(bool infoPreview READ isInfoPreviewEnabled WRITE setInfoPreviewEnabled)

   109     Q_PROPERTY(bool contentsPreview READ isContentsPreviewEnabled WRITE setContentsPreviewEnabled)

   110 

   111 public:

   112     Q3FileDialog(const QString& dirName, const QString& filter = QString(),

   113                  QWidget* parent=0, const char* name=0, bool modal = false);

   114     Q3FileDialog(QWidget* parent=0, const char* name=0, bool modal = false);

   115     ~Q3FileDialog();

   116 

   117     // recommended static functions

   118 

   119     static QString getOpenFileName(const QString &initially = QString(),

   120                                     const QString &filter = QString(),

   121                                     QWidget *parent = 0, const char* name = 0,

   122                                     const QString &caption = QString(),

   123                                     QString *selectedFilter = 0,

   124                                     bool resolveSymlinks = true);

   125     static QString getSaveFileName(const QString &initially = QString(),

   126                                     const QString &filter = QString(),

   127                                     QWidget *parent = 0, const char* name = 0,

   128                                     const QString &caption = QString(),

   129                                     QString *selectedFilter = 0,

   130                                     bool resolveSymlinks = true);

   131     static QString getExistingDirectory(const QString &dir = QString(),

   132                                          QWidget *parent = 0,

   133                                          const char* name = 0,

   134                                          const QString &caption = QString(),

   135                                          bool dirOnly = true,

   136                                          bool resolveSymlinks = true);

   137     static QStringList getOpenFileNames(const QString &filter= QString(),

   138                                          const QString &dir = QString(),

   139                                          QWidget *parent = 0,

   140                                          const char* name = 0,

   141                                          const QString &caption = QString(),

   142                                          QString *selectedFilter = 0,

   143                                          bool resolveSymlinks = true);

   144 

   145     // other static functions

   146 

   147     static void setIconProvider(Q3FileIconProvider *);

   148     static Q3FileIconProvider * iconProvider();

   149 

   150     // non-static function for special needs

   151 

   152     QString selectedFile() const;

   153     QString selectedFilter() const;

   154     virtual void setSelectedFilter(const QString&);

   155     virtual void setSelectedFilter(int);

   156 

   157     void setSelection(const QString &);

   158 

   159     void selectAll(bool b);

   160 

   161     QStringList selectedFiles() const;

   162 

   163     QString dirPath() const;

   164 

   165     void setDir(const QDir &);

   166     const QDir *dir() const;

   167 

   168     void setShowHiddenFiles(bool s);

   169     bool showHiddenFiles() const;

   170 

   171     void rereadDir();

   172     void resortDir();

   173 

   174     enum Mode { AnyFile, ExistingFile, Directory, ExistingFiles, DirectoryOnly };

   175     void setMode(Mode);

   176     Mode mode() const;

   177 

   178     enum ViewMode { Detail, List };

   179     enum PreviewMode { NoPreview, Contents, Info };

   180     void setViewMode(ViewMode m);

   181     ViewMode viewMode() const;

   182     void setPreviewMode(PreviewMode m);

   183     PreviewMode previewMode() const;

   184 

   185     bool eventFilter(QObject *, QEvent *);

   186 

   187     bool isInfoPreviewEnabled() const;

   188     bool isContentsPreviewEnabled() const;

   189     void setInfoPreviewEnabled(bool);

   190     void setContentsPreviewEnabled(bool);

   191 

   192     void setInfoPreview(QWidget *w, Q3FilePreview *preview);

   193     void setContentsPreview(QWidget *w, Q3FilePreview *preview);

   194 

   195     Q3Url url() const;

   196 

   197     void addFilter(const QString &filter);

   198 

   199 public Q_SLOTS:

   200     void done(int);

   201     void setDir(const QString&);

   202     void setUrl(const Q3UrlOperator &url);

   203     void setFilter(const QString&);

   204     void setFilters(const QString&);

   205     void setFilters(const char **);

   206     void setFilters(const QStringList&);

   207 

   208 protected:

   209     void resizeEvent(QResizeEvent *);

   210     void keyPressEvent(QKeyEvent *);

   211 

   212     void addWidgets(QLabel *, QWidget *, QPushButton *);

   213     void addToolButton(QAbstractButton *b, bool separator = false);

   214     void addLeftWidget(QWidget *w);

   215     void addRightWidget(QWidget *w);

   216 

   217 Q_SIGNALS:

   218     void fileHighlighted(const QString&);

   219     void fileSelected(const QString&);

   220     void filesSelected(const QStringList&);

   221     void dirEntered(const QString&);

   222     void filterSelected(const QString&);

   223 

   224 private Q_SLOTS:

   225     void detailViewSelectionChanged();

   226     void listBoxSelectionChanged();

   227     void changeMode(int);

   228     void fileNameEditReturnPressed();

   229     void stopCopy();

   230     void removeProgressDia();

   231 

   232     void fileSelected(int);

   233     void fileHighlighted(int);

   234     void dirSelected(int);

   235     void pathSelected(int);

   236 

   237     void updateFileNameEdit(Q3ListViewItem *);

   238     void selectDirectoryOrFile(Q3ListViewItem *);

   239     void popupContextMenu(Q3ListViewItem *, const QPoint &, int);

   240     void popupContextMenu(Q3ListBoxItem *, const QPoint &);

   241     void updateFileNameEdit(Q3ListBoxItem *);

   242     void selectDirectoryOrFile(Q3ListBoxItem *);

   243     void fileNameEditDone();

   244 

   245     void okClicked();

   246     void filterClicked(); // not used

   247     void cancelClicked();

   248 

   249     void cdUpClicked();

   250     void newFolderClicked();

   251 

   252     void fixupNameEdit();

   253 

   254     void doMimeTypeLookup();

   255 

   256     void updateGeometries();

   257     void modeButtonsDestroyed();

   258     void urlStart(Q3NetworkOperation *op);

   259     void urlFinished(Q3NetworkOperation *op);

   260     void dataTransferProgress(int bytesDone, int bytesTotal, Q3NetworkOperation *);

   261     void insertEntry(const Q3ValueList<QUrlInfo> &fi, Q3NetworkOperation *op);

   262     void removeEntry(Q3NetworkOperation *);

   263     void createdDirectory(const QUrlInfo &info, Q3NetworkOperation *);

   264     void itemChanged(Q3NetworkOperation *);

   265     void goBack();

   266 

   267 private:

   268     Q_DISABLE_COPY(Q3FileDialog)

   269 

   270     enum PopupAction {

   271         PA_Open = 0,

   272         PA_Delete,

   273         PA_Rename,

   274         PA_SortName,

   275         PA_SortSize,

   276         PA_SortType,

   277         PA_SortDate,

   278         PA_SortUnsorted,

   279         PA_Cancel,

   280         PA_Reload,

   281         PA_Hidden

   282     };

   283 

   284     void init();

   285     bool trySetSelection(bool isDir, const Q3UrlOperator &, bool);

   286     void deleteFile(const QString &filename);

   287     void popupContextMenu(const QString &filename, bool withSort,

   288                            PopupAction &action, const QPoint &p);

   289     void updatePreviews(const Q3Url &u);

   290 

   291     QString fileName;

   292 

   293     friend class Q3FileDialogQFileListView;

   294     friend class QFileListBox;

   295 

   296     Q3FileDialogPrivate *d;

   297     Q3FileDialogQFileListView  *files;

   298 

   299     QLineEdit  *nameEdit; // also filter

   300     QPushButton *okB;

   301     QPushButton *cancelB;

   302 

   303 #if defined(Q_WS_WIN)

   304     static QString winGetOpenFileName(const QString &initialSelection,

   305                                        const QString &filter,

   306                                        QString* workingDirectory,

   307                                        QWidget *parent = 0,

   308                                        const char* name = 0,

   309                                        const QString& caption = QString(),

   310                                        QString* selectedFilter = 0);

   311     static QString winGetSaveFileName(const QString &initialSelection,

   312                                        const QString &filter,

   313                                        QString* workingDirectory,

   314                                        QWidget *parent = 0,

   315                                        const char* name = 0,

   316                                        const QString& caption = QString(),

   317                                        QString* selectedFilter = 0);

   318     static QStringList winGetOpenFileNames(const QString &filter,

   319                                             QString* workingDirectory,

   320                                             QWidget *parent = 0,

   321                                             const char* name = 0,

   322                                             const QString& caption = QString(),

   323                                             QString* selectedFilter = 0);

   324     static QString winGetExistingDirectory(const QString &initialDirectory,

   325                                             QWidget* parent = 0,

   326                                             const char* name = 0,

   327                                             const QString& caption = QString());

   328     static QString resolveLinkFile(const QString& linkfile);

   329     int old_qt_ntfs_permission_lookup;

   330 #endif

   331 #if defined(Q_WS_MAC)

   332     static QString macGetSaveFileName(const QString &, const QString &,

   333                                        QString *, QWidget *, const char*,

   334                                        const QString&, QString *);

   335     static QStringList macGetOpenFileNames(const QString &, QString*,

   336                                             QWidget *, const char *,

   337                                             const QString&, QString *,

   338                                             bool = true, bool = false);

   339 #endif

   340 };

   341 

   342 #endif // QT_MAC_USE_COCOA

   343 

   344 #endif // QT_NO_FILEDIALOG

   345 

   346 QT_END_NAMESPACE

   347 

   348 QT_END_HEADER

   349 

   350 #endif // Q3FILEDIALOG_H