qfiledialog.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:13k
源码类别:

系统编程

开发平台:

Unix_Linux

  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
  4. ** Contact: Qt Software Information (qt-info@nokia.com)
  5. **
  6. ** This file is part of the QtGui module of the Qt Toolkit.
  7. **
  8. ** Commercial Usage
  9. ** Licensees holding valid Qt Commercial licenses may use this file in
  10. ** accordance with the Qt Commercial License Agreement provided with the
  11. ** Software or, alternatively, in accordance with the terms contained in
  12. ** a written agreement between you and Nokia.
  13. **
  14. **
  15. ** GNU General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU
  17. ** General Public License versions 2.0 or 3.0 as published by the Free
  18. ** Software Foundation and appearing in the file LICENSE.GPL included in
  19. ** the packaging of this file.  Please review the following information
  20. ** to ensure GNU General Public Licensing requirements will be met:
  21. ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
  22. ** http://www.gnu.org/copyleft/gpl.html.  In addition, as a special
  23. ** exception, Nokia gives you certain additional rights. These rights
  24. ** are described in the Nokia Qt GPL Exception version 1.3, included in
  25. ** the file GPL_EXCEPTION.txt in this package.
  26. **
  27. ** Qt for Windows(R) Licensees
  28. ** As a special exception, Nokia, as the sole copyright holder for Qt
  29. ** Designer, grants users of the Qt/Eclipse Integration plug-in the
  30. ** right for the Qt/Eclipse Integration to link to functionality
  31. ** provided by Qt Designer and its related libraries.
  32. **
  33. ** If you are unsure which license is appropriate for your use, please
  34. ** contact the sales department at qt-sales@nokia.com.
  35. **
  36. ****************************************************************************/
  37. #ifndef QFILEDIALOG_H
  38. #define QFILEDIALOG_H
  39. #include <QtCore/qdir.h>
  40. #include <QtCore/qstring.h>
  41. #include <QtGui/qdialog.h>
  42. QT_BEGIN_HEADER
  43. QT_BEGIN_NAMESPACE
  44. QT_MODULE(Gui)
  45. #ifndef QT_NO_FILEDIALOG
  46. class QModelIndex;
  47. class QItemSelection;
  48. struct QFileDialogArgs;
  49. class QFileIconProvider;
  50. class QFileDialogPrivate;
  51. class QAbstractItemDelegate;
  52. class QAbstractProxyModel;
  53. class QUrl;
  54. class Q_GUI_EXPORT QFileDialog : public QDialog
  55. {
  56.     Q_OBJECT
  57.     Q_PROPERTY(ViewMode viewMode READ viewMode WRITE setViewMode)
  58.     Q_PROPERTY(FileMode fileMode READ fileMode WRITE setFileMode)
  59.     Q_PROPERTY(AcceptMode acceptMode READ acceptMode WRITE setAcceptMode)
  60.     Q_PROPERTY(bool readOnly READ isReadOnly WRITE setReadOnly)
  61.     Q_PROPERTY(bool resolveSymlinks READ resolveSymlinks WRITE setResolveSymlinks)
  62.     Q_PROPERTY(bool confirmOverwrite READ confirmOverwrite WRITE setConfirmOverwrite)
  63.     Q_PROPERTY(QString defaultSuffix READ defaultSuffix WRITE setDefaultSuffix)
  64.     Q_PROPERTY(bool nameFilterDetailsVisible READ isNameFilterDetailsVisible WRITE setNameFilterDetailsVisible)
  65.     Q_ENUMS(ViewMode FileMode AcceptMode)
  66. public:
  67.     enum ViewMode { Detail, List };
  68.     enum FileMode { AnyFile, ExistingFile, Directory, ExistingFiles, DirectoryOnly };
  69.     enum AcceptMode { AcceptOpen, AcceptSave };
  70.     enum DialogLabel { LookIn, FileName, FileType, Accept, Reject };
  71.     enum Option {
  72.         ShowDirsOnly = 0x01,
  73.         DontResolveSymlinks = 0x02,
  74.         DontConfirmOverwrite = 0x04,
  75.         DontUseSheet = 0x08,
  76.         DontUseNativeDialog = 0x10
  77.     };
  78.     Q_DECLARE_FLAGS(Options, Option)
  79.     QFileDialog(QWidget *parent, Qt::WindowFlags f);
  80.     explicit QFileDialog(QWidget *parent = 0,
  81.                          const QString &caption = QString(),
  82.                          const QString &directory = QString(),
  83.                          const QString &filter = QString());
  84.     ~QFileDialog();
  85.     void setDirectory(const QString &directory);
  86.     inline void setDirectory(const QDir &directory);
  87.     QDir directory() const;
  88.     void selectFile(const QString &filename);
  89.     QStringList selectedFiles() const;
  90. #ifdef QT_DEPRECATED
  91.     QT_DEPRECATED void setFilter(const QString &filter);
  92.     QT_DEPRECATED void setFilters(const QStringList &filters);
  93.     QT_DEPRECATED QStringList filters() const;
  94.     QT_DEPRECATED void selectFilter(const QString &filter);
  95.     QT_DEPRECATED QString selectedFilter() const;
  96. #endif
  97.     void setNameFilterDetailsVisible(bool enabled);
  98.     bool isNameFilterDetailsVisible() const;
  99.     void setNameFilter(const QString &filter);
  100.     void setNameFilters(const QStringList &filters);
  101.     QStringList nameFilters() const;
  102.     void selectNameFilter(const QString &filter);
  103.     QString selectedNameFilter() const;
  104.     QDir::Filters filter() const;
  105.     void setFilter(QDir::Filters filters);
  106.     void setViewMode(ViewMode mode);
  107.     ViewMode viewMode() const;
  108.     void setFileMode(FileMode mode);
  109.     FileMode fileMode() const;
  110.     void setAcceptMode(AcceptMode mode);
  111.     AcceptMode acceptMode() const;
  112.     void setReadOnly(bool enabled);
  113.     bool isReadOnly() const;
  114.     void setResolveSymlinks(bool enabled);
  115.     bool resolveSymlinks() const;
  116.     void setSidebarUrls(const QList<QUrl> &urls);
  117.     QList<QUrl> sidebarUrls() const;
  118.     QByteArray saveState() const;
  119.     bool restoreState(const QByteArray &state);
  120.     void setConfirmOverwrite(bool enabled);
  121.     bool confirmOverwrite() const;
  122.     void setDefaultSuffix(const QString &suffix);
  123.     QString defaultSuffix() const;
  124.     void setHistory(const QStringList &paths);
  125.     QStringList history() const;
  126.     void setItemDelegate(QAbstractItemDelegate *delegate);
  127.     QAbstractItemDelegate *itemDelegate() const;
  128.     void setIconProvider(QFileIconProvider *provider);
  129.     QFileIconProvider *iconProvider() const;
  130.     void setLabelText(DialogLabel label, const QString &text);
  131.     QString labelText(DialogLabel label) const;
  132. #ifndef QT_NO_PROXYMODEL
  133.     void setProxyModel(QAbstractProxyModel *model);
  134.     QAbstractProxyModel *proxyModel() const;
  135. #endif
  136. Q_SIGNALS:
  137.     void filesSelected(const QStringList &files);
  138.     void currentChanged(const QString &path);
  139.     void directoryEntered(const QString &directory);
  140.     void filterSelected(const QString &filter);
  141. public:
  142. #ifdef QT3_SUPPORT
  143.     typedef FileMode Mode;
  144.     inline QT3_SUPPORT void setMode(FileMode m) { setFileMode(m); }
  145.     inline QT3_SUPPORT FileMode mode() const { return fileMode(); }
  146.     inline QT3_SUPPORT void setDir(const QString &directory) { setDirectory(directory); }
  147.     inline QT3_SUPPORT void setDir( const QDir &directory ) { setDirectory(directory); }
  148.     QT3_SUPPORT QString selectedFile() const;
  149. #endif
  150.     static QString getOpenFileName(QWidget *parent = 0,
  151.                                    const QString &caption = QString(),
  152.                                    const QString &dir = QString(),
  153.                                    const QString &filter = QString(),
  154.                                    QString *selectedFilter = 0,
  155.                                    Options options = 0);
  156.     static QString getSaveFileName(QWidget *parent = 0,
  157.                                    const QString &caption = QString(),
  158.                                    const QString &dir = QString(),
  159.                                    const QString &filter = QString(),
  160.                                    QString *selectedFilter = 0,
  161.                                    Options options = 0);
  162.     static QString getExistingDirectory(QWidget *parent = 0,
  163.                                         const QString &caption = QString(),
  164.                                         const QString &dir = QString(),
  165.                                         Options options = ShowDirsOnly);
  166.     static QStringList getOpenFileNames(QWidget *parent = 0,
  167.                                         const QString &caption = QString(),
  168.                                         const QString &dir = QString(),
  169.                                         const QString &filter = QString(),
  170.                                         QString *selectedFilter = 0,
  171.                                         Options options = 0);
  172. #ifdef QT3_SUPPORT
  173.     inline static QString QT3_SUPPORT getOpenFileName(const QString &dir,
  174.                                                     const QString &filter = QString(),
  175.                                                     QWidget *parent = 0, const char* name = 0,
  176.                                                     const QString &caption = QString(),
  177.                                                     QString *selectedFilter = 0,
  178.                                                     bool resolveSymlinks = true)
  179.         { Q_UNUSED(name);
  180.           return getOpenFileName(parent, caption, dir, filter, selectedFilter,
  181.                                  resolveSymlinks ? Option(0) : DontResolveSymlinks); }
  182.     inline static QString QT3_SUPPORT getSaveFileName(const QString &dir,
  183.                                                     const QString &filter = QString(),
  184.                                                     QWidget *parent = 0, const char* name = 0,
  185.                                                     const QString &caption = QString(),
  186.                                                     QString *selectedFilter = 0,
  187.                                                     bool resolveSymlinks = true)
  188.         { Q_UNUSED(name);
  189.           return getSaveFileName(parent, caption, dir, filter, selectedFilter,
  190.                                  resolveSymlinks ? Option(0) : DontResolveSymlinks); }
  191.     inline static QString QT3_SUPPORT getExistingDirectory(const QString &dir,
  192.                                                          QWidget *parent = 0,
  193.                                                          const char* name = 0,
  194.                                                          const QString &caption = QString(),
  195.                                                          bool dirOnly = true,
  196.                                                          bool resolveSymlinks = true)
  197.         { Q_UNUSED(name);
  198.           return getExistingDirectory(parent, caption, dir,
  199.                                       Options((resolveSymlinks ? Option(0) : DontResolveSymlinks)
  200.                                       | (dirOnly ? ShowDirsOnly : Option(0)))); }
  201.     inline static QStringList QT3_SUPPORT getOpenFileNames(const QString &filter,
  202.                                                          const QString &dir = QString(),
  203.                                                          QWidget *parent = 0,
  204.                                                          const char* name = 0,
  205.                                                          const QString &caption = QString(),
  206.                                                          QString *selectedFilter = 0,
  207.                                                          bool resolveSymlinks = true)
  208.         { Q_UNUSED(name);
  209.           return getOpenFileNames(parent, caption, dir, filter, selectedFilter,
  210.                                   resolveSymlinks ? Option(0) : DontResolveSymlinks); }
  211. #endif // QT3_SUPPORT
  212. protected:
  213.     QFileDialog(const QFileDialogArgs &args);
  214.     void done(int result);
  215.     void accept();
  216.     void changeEvent(QEvent *e);
  217. private:
  218.     Q_DECLARE_PRIVATE(QFileDialog)
  219.     Q_DISABLE_COPY(QFileDialog)
  220.     Q_PRIVATE_SLOT(d_func(), void _q_pathChanged(const QString &))
  221.     Q_PRIVATE_SLOT(d_func(), void _q_navigateBackward())
  222.     Q_PRIVATE_SLOT(d_func(), void _q_navigateForward())
  223.     Q_PRIVATE_SLOT(d_func(), void _q_navigateToParent())
  224.     Q_PRIVATE_SLOT(d_func(), void _q_createDirectory())
  225.     Q_PRIVATE_SLOT(d_func(), void _q_showListView())
  226.     Q_PRIVATE_SLOT(d_func(), void _q_showDetailsView())
  227.     Q_PRIVATE_SLOT(d_func(), void _q_showContextMenu(const QPoint &))
  228.     Q_PRIVATE_SLOT(d_func(), void _q_renameCurrent())
  229.     Q_PRIVATE_SLOT(d_func(), void _q_deleteCurrent())
  230.     Q_PRIVATE_SLOT(d_func(), void _q_showHidden())
  231.     Q_PRIVATE_SLOT(d_func(), void _q_updateOkButton())
  232.     Q_PRIVATE_SLOT(d_func(), void _q_currentChanged(const QModelIndex &index))
  233.     Q_PRIVATE_SLOT(d_func(), void _q_enterDirectory(const QModelIndex &index))
  234.     Q_PRIVATE_SLOT(d_func(), void _q_goToDirectory(const QString &path))
  235.     Q_PRIVATE_SLOT(d_func(), void _q_useNameFilter(int index))
  236.     Q_PRIVATE_SLOT(d_func(), void _q_selectionChanged())
  237.     Q_PRIVATE_SLOT(d_func(), void _q_goToUrl(const QUrl &url))
  238.     Q_PRIVATE_SLOT(d_func(), void _q_goHome())
  239.     Q_PRIVATE_SLOT(d_func(), void _q_showHeader(QAction *))
  240.     Q_PRIVATE_SLOT(d_func(), void _q_autoCompleteFileName(const QString &text))
  241.     Q_PRIVATE_SLOT(d_func(), void _q_rowsInserted(const QModelIndex & parent))
  242.     Q_PRIVATE_SLOT(d_func(), void _q_fileRenamed(const QString &path,
  243.                 const QString oldName, const QString newName))
  244. };
  245. inline void QFileDialog::setDirectory(const QDir &adirectory)
  246. { setDirectory(adirectory.absolutePath()); }
  247. Q_DECLARE_OPERATORS_FOR_FLAGS(QFileDialog::Options)
  248. #endif // QT_NO_FILEDIALOG
  249. QT_END_NAMESPACE
  250. QT_END_HEADER
  251. #endif // QFILEDIALOG_H