source: trunk/include/qfiledialog.h@ 56

Last change on this file since 56 was 2, checked in by dmik, 20 years ago

Imported xplatform parts of the official release 3.3.1 from Trolltech
  • Property svn:keywords set to Id
File size: 11.0 KB
Line 
1/****************************************************************************
2** $Id: qfiledialog.h 2 2005-11-16 15:49:26Z dmik $
3**
4** Definition of QFileDialog class
5**
6** Created : 950428
7**
8** Copyright (C) 1992-2000 Trolltech AS. All rights reserved.
9**
10** This file is part of the dialogs module of the Qt GUI Toolkit.
11**
12** This file may be distributed under the terms of the Q Public License
13** as defined by Trolltech AS of Norway and appearing in the file
14** LICENSE.QPL included in the packaging of this file.
15**
16** This file may be distributed and/or modified under the terms of the
17** GNU General Public License version 2 as published by the Free Software
18** Foundation and appearing in the file LICENSE.GPL included in the
19** packaging of this file.
20**
21** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition
22** licenses may use this file in accordance with the Qt Commercial License
23** Agreement provided with the Software.
24**
25** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
26** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
27**
28** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
29** information about Qt Commercial License Agreements.
30** See http://www.trolltech.com/qpl/ for QPL licensing information.
31** See http://www.trolltech.com/gpl/ for GPL licensing information.
32**
33** Contact info@trolltech.com if any conditions of this licensing are
34** not clear to you.
35**
36**********************************************************************/
37
38#ifndef QFILEDIALOG_H
39#define QFILEDIALOG_H
40
41class QPushButton;
42class QButton;
43class QLabel;
44class QWidget;
45class QFileDialog;
46class QTimer;
47class QNetworkOperation;
48class QLineEdit;
49class QListViewItem;
50class QListBoxItem;
51class QFileDialogPrivate;
52class QFileDialogQFileListView;
53
54#ifndef QT_H
55#include "qdir.h"
56#include "qdialog.h"
57#include "qurloperator.h"
58#include "qurlinfo.h"
59#endif // QT_H
60
61#ifndef QT_NO_FILEDIALOG
62
63class Q_EXPORT QFileIconProvider : public QObject
64{
65 Q_OBJECT
66public:
67 QFileIconProvider( QObject * parent = 0, const char* name = 0 );
68 virtual const QPixmap * pixmap( const QFileInfo & );
69
70private: // Disabled copy constructor and operator=
71#if defined(Q_DISABLE_COPY)
72 QFileIconProvider( const QFileIconProvider & );
73 QFileIconProvider& operator=( const QFileIconProvider & );
74#endif
75};
76
77class Q_EXPORT QFilePreview
78{
79public:
80 QFilePreview();
81 virtual void previewUrl( const QUrl &url ) = 0;
82
83};
84
85class Q_EXPORT QFileDialog : public QDialog
86{
87 Q_OBJECT
88 Q_ENUMS( Mode ViewMode PreviewMode )
89 // ##### Why are this read-only properties ?
90 Q_PROPERTY( QString selectedFile READ selectedFile )
91 Q_PROPERTY( QString selectedFilter READ selectedFilter )
92 Q_PROPERTY( QStringList selectedFiles READ selectedFiles )
93 // #### Should not we be able to set the path ?
94 Q_PROPERTY( QString dirPath READ dirPath )
95 Q_PROPERTY( bool showHiddenFiles READ showHiddenFiles WRITE setShowHiddenFiles )
96 Q_PROPERTY( Mode mode READ mode WRITE setMode )
97 Q_PROPERTY( ViewMode viewMode READ viewMode WRITE setViewMode )
98 Q_PROPERTY( PreviewMode previewMode READ previewMode WRITE setPreviewMode )
99 Q_PROPERTY( bool infoPreview READ isInfoPreviewEnabled WRITE setInfoPreviewEnabled )
100 Q_PROPERTY( bool contentsPreview READ isContentsPreviewEnabled WRITE setContentsPreviewEnabled )
101
102public:
103 QFileDialog( const QString& dirName, const QString& filter = QString::null,
104 QWidget* parent=0, const char* name=0, bool modal = FALSE );
105 QFileDialog( QWidget* parent=0, const char* name=0, bool modal = FALSE );
106 ~QFileDialog();
107
108 // recommended static functions
109
110 static QString getOpenFileName( const QString &initially = QString::null,
111 const QString &filter = QString::null,
112 QWidget *parent = 0, const char* name = 0,
113 const QString &caption = QString::null,
114 QString *selectedFilter = 0,
115 bool resolveSymlinks = TRUE);
116 static QString getSaveFileName( const QString &initially = QString::null,
117 const QString &filter = QString::null,
118 QWidget *parent = 0, const char* name = 0,
119 const QString &caption = QString::null,
120 QString *selectedFilter = 0,
121 bool resolveSymlinks = TRUE);
122 static QString getExistingDirectory( const QString &dir = QString::null,
123 QWidget *parent = 0,
124 const char* name = 0,
125 const QString &caption = QString::null,
126 bool dirOnly = TRUE,
127 bool resolveSymlinks = TRUE);
128 static QStringList getOpenFileNames( const QString &filter= QString::null,
129 const QString &dir = QString::null,
130 QWidget *parent = 0,
131 const char* name = 0,
132 const QString &caption = QString::null,
133 QString *selectedFilter = 0,
134 bool resolveSymlinks = TRUE);
135
136 // other static functions
137
138 static void setIconProvider( QFileIconProvider * );
139 static QFileIconProvider * iconProvider();
140
141 // non-static function for special needs
142
143 QString selectedFile() const;
144 QString selectedFilter() const;
145 virtual void setSelectedFilter( const QString& );
146 virtual void setSelectedFilter( int );
147
148 void setSelection( const QString &);
149
150 void selectAll( bool b );
151
152 QStringList selectedFiles() const;
153
154 QString dirPath() const;
155
156 void setDir( const QDir & );
157 const QDir *dir() const;
158
159 void setShowHiddenFiles( bool s );
160 bool showHiddenFiles() const;
161
162 void rereadDir();
163 void resortDir();
164
165 enum Mode { AnyFile, ExistingFile, Directory, ExistingFiles, DirectoryOnly };
166 void setMode( Mode );
167 Mode mode() const;
168
169 enum ViewMode { Detail, List };
170 enum PreviewMode { NoPreview, Contents, Info };
171 void setViewMode( ViewMode m );
172 ViewMode viewMode() const;
173 void setPreviewMode( PreviewMode m );
174 PreviewMode previewMode() const;
175
176 bool eventFilter( QObject *, QEvent * );
177
178 bool isInfoPreviewEnabled() const;
179 bool isContentsPreviewEnabled() const;
180 void setInfoPreviewEnabled( bool );
181 void setContentsPreviewEnabled( bool );
182
183 void setInfoPreview( QWidget *w, QFilePreview *preview );
184 void setContentsPreview( QWidget *w, QFilePreview *preview );
185
186 QUrl url() const;
187
188 void addFilter( const QString &filter );
189
190public slots:
191 void done( int );
192 void setDir( const QString& );
193 void setUrl( const QUrlOperator &url );
194 void setFilter( const QString& );
195 void setFilters( const QString& );
196 void setFilters( const char ** );
197 void setFilters( const QStringList& );
198
199protected:
200 void resizeEvent( QResizeEvent * );
201 void keyPressEvent( QKeyEvent * );
202
203 void addWidgets( QLabel *, QWidget *, QPushButton * );
204 void addToolButton( QButton *b, bool separator = FALSE );
205 void addLeftWidget( QWidget *w );
206 void addRightWidget( QWidget *w );
207
208signals:
209 void fileHighlighted( const QString& );
210 void fileSelected( const QString& );
211 void filesSelected( const QStringList& );
212 void dirEntered( const QString& );
213 void filterSelected( const QString& );
214
215private slots:
216 void detailViewSelectionChanged();
217 void listBoxSelectionChanged();
218 void changeMode( int );
219 void fileNameEditReturnPressed();
220 void stopCopy();
221 void removeProgressDia();
222
223 void fileSelected( int );
224 void fileHighlighted( int );
225 void dirSelected( int );
226 void pathSelected( int );
227
228 void updateFileNameEdit( QListViewItem *);
229 void selectDirectoryOrFile( QListViewItem * );
230 void popupContextMenu( QListViewItem *, const QPoint &, int );
231 void popupContextMenu( QListBoxItem *, const QPoint & );
232 void updateFileNameEdit( QListBoxItem *);
233 void selectDirectoryOrFile( QListBoxItem * );
234 void fileNameEditDone();
235
236 void okClicked();
237 void filterClicked(); // not used
238 void cancelClicked();
239
240 void cdUpClicked();
241 void newFolderClicked();
242
243 void fixupNameEdit();
244
245 void doMimeTypeLookup();
246
247 void updateGeometries();
248 void modeButtonsDestroyed();
249 void urlStart( QNetworkOperation *op );
250 void urlFinished( QNetworkOperation *op );
251 void dataTransferProgress( int bytesDone, int bytesTotal, QNetworkOperation * );
252 void insertEntry( const QValueList<QUrlInfo> &fi, QNetworkOperation *op );
253 void removeEntry( QNetworkOperation * );
254 void createdDirectory( const QUrlInfo &info, QNetworkOperation * );
255 void itemChanged( QNetworkOperation * );
256 void goBack();
257
258private:
259 enum PopupAction {
260 PA_Open = 0,
261 PA_Delete,
262 PA_Rename,
263 PA_SortName,
264 PA_SortSize,
265 PA_SortType,
266 PA_SortDate,
267 PA_SortUnsorted,
268 PA_Cancel,
269 PA_Reload,
270 PA_Hidden
271 };
272
273 void init();
274 bool trySetSelection( bool isDir, const QUrlOperator &, bool );
275 void deleteFile( const QString &filename );
276 void popupContextMenu( const QString &filename, bool withSort,
277 PopupAction &action, const QPoint &p );
278 void updatePreviews( const QUrl &u );
279
280 QDir reserved; // was cwd
281 QString fileName;
282
283 friend class QFileDialogQFileListView;
284 friend class QFileListBox;
285
286 QFileDialogPrivate *d;
287 QFileDialogQFileListView *files;
288
289 QLineEdit *nameEdit; // also filter
290 QPushButton *okB;
291 QPushButton *cancelB;
292
293#if defined(Q_WS_WIN)
294 static QString winGetOpenFileName( const QString &initialSelection,
295 const QString &filter,
296 QString* workingDirectory,
297 QWidget *parent = 0,
298 const char* name = 0,
299 const QString& caption = QString::null,
300 QString* selectedFilter = 0 );
301 static QString winGetSaveFileName( const QString &initialSelection,
302 const QString &filter,
303 QString* workingDirectory,
304 QWidget *parent = 0,
305 const char* name = 0,
306 const QString& caption = QString::null,
307 QString* selectedFilter = 0 );
308 static QStringList winGetOpenFileNames( const QString &filter,
309 QString* workingDirectory,
310 QWidget *parent = 0,
311 const char* name = 0,
312 const QString& caption = QString::null,
313 QString* selectedFilter = 0 );
314 static QString winGetExistingDirectory( const QString &initialDirectory,
315 QWidget* parent = 0,
316 const char* name = 0,
317 const QString& caption = QString::null);
318 static QString resolveLinkFile( const QString& linkfile );
319#endif
320#if defined(Q_WS_MACX) || defined(Q_WS_MAC9)
321 static QString macGetSaveFileName( const QString &, const QString &,
322 QString *, QWidget *, const char*,
323 const QString&, QString *);
324 static QStringList macGetOpenFileNames( const QString &, QString*,
325 QWidget *, const char *,
326 const QString&, QString *,
327 bool = TRUE, bool = FALSE );
328#endif
329
330
331private: // Disabled copy constructor and operator=
332#if defined(Q_DISABLE_COPY)
333 QFileDialog( const QFileDialog & );
334 QFileDialog &operator=( const QFileDialog & );
335#endif
336};
337
338#endif
339
340#endif // QFILEDIALOG_H
Note: See TracBrowser for help on using the repository browser.