<?xml version="1.0" encoding="iso-8859-1"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd"> <html><head><title>QFileDialog Class Reference</title><style>h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm } a:link { color: #004faf; text-decoration: none } a:visited { color: #672967; text-decoration: none } td.postheader { font-family: sans-serif } tr.address { font-family: sans-serif } body { background: #ffffff; color: black; } </style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr /><td align="left" valign="top" width="32"><img align="left" border="0" height="32" src="images/rb-logo.png" width="32" /></td><td width="1">  </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QFileDialog Class Reference<br /><sup><sup>[<a href="qtgui.html">QtGui</a> module]</sup></sup></h1><p>The QFileDialog class provides a dialog that allow users to select files or directories. <a href="#details">More...</a></p> <p>Inherits <a href="qdialog.html">QDialog</a>.</p><h3>Types</h3><ul><li><div class="fn" />enum <b><a href="qfiledialog.html#AcceptMode-enum">AcceptMode</a></b> { AcceptOpen, AcceptSave }</li><li><div class="fn" />enum <b><a href="qfiledialog.html#DialogLabel-enum">DialogLabel</a></b> { LookIn, FileName, FileType, Accept, Reject }</li><li><div class="fn" />enum <b><a href="qfiledialog.html#FileMode-enum">FileMode</a></b> { AnyFile, ExistingFile, Directory, ExistingFiles, DirectoryOnly }</li><li><div class="fn" />enum <b><a href="qfiledialog.html#Option-enum">Option</a></b> { ShowDirsOnly, DontResolveSymlinks, DontConfirmOverwrite, DontUseSheet, ..., HideNameFilterDetails }</li><li><div class="fn" />class <b><a href="qfiledialog-options.html">Options</a></b></li><li><div class="fn" />enum <b><a href="qfiledialog.html#ViewMode-enum">ViewMode</a></b> { Detail, List }</li></ul><h3>Methods</h3><ul><li><div class="fn" /><b><a href="qfiledialog.html#QFileDialog">__init__</a></b> (<i>self</i>, QWidget <i>parent</i>, Qt.WindowFlags <i>f</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#QFileDialog-2">__init__</a></b> (<i>self</i>, QWidget <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString())</li><li><div class="fn" /><b><a href="qfiledialog.html#accept">accept</a></b> (<i>self</i>)</li><li><div class="fn" />AcceptMode <b><a href="qfiledialog.html#acceptMode">acceptMode</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#changeEvent">changeEvent</a></b> (<i>self</i>, QEvent <i>e</i>)</li><li><div class="fn" />bool <b><a href="qfiledialog.html#confirmOverwrite">confirmOverwrite</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qfiledialog.html#defaultSuffix">defaultSuffix</a></b> (<i>self</i>)</li><li><div class="fn" />QDir <b><a href="qfiledialog.html#directory">directory</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#done">done</a></b> (<i>self</i>, int <i>result</i>)</li><li><div class="fn" />FileMode <b><a href="qfiledialog.html#fileMode">fileMode</a></b> (<i>self</i>)</li><li><div class="fn" />QDir.Filters <b><a href="qfiledialog.html#filter">filter</a></b> (<i>self</i>)</li><li><div class="fn" />QStringList <b><a href="qfiledialog.html#filters">filters</a></b> (<i>self</i>)</li><li><div class="fn" />QStringList <b><a href="qfiledialog.html#history">history</a></b> (<i>self</i>)</li><li><div class="fn" />QFileIconProvider <b><a href="qfiledialog.html#iconProvider">iconProvider</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qfiledialog.html#isNameFilterDetailsVisible">isNameFilterDetailsVisible</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qfiledialog.html#isReadOnly">isReadOnly</a></b> (<i>self</i>)</li><li><div class="fn" />QAbstractItemDelegate <b><a href="qfiledialog.html#itemDelegate">itemDelegate</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qfiledialog.html#labelText">labelText</a></b> (<i>self</i>, DialogLabel <i>label</i>)</li><li><div class="fn" />QStringList <b><a href="qfiledialog.html#nameFilters">nameFilters</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#open">open</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#open-2">open</a></b> (<i>self</i>, QObject <i>receiver</i>, SLOT()SLOT() <i>member</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#open-3">open</a></b> (<i>self</i>, callable <i>receiver</i>)</li><li><div class="fn" />Options <b><a href="qfiledialog.html#options">options</a></b> (<i>self</i>)</li><li><div class="fn" />QAbstractProxyModel <b><a href="qfiledialog.html#proxyModel">proxyModel</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qfiledialog.html#resolveSymlinks">resolveSymlinks</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qfiledialog.html#restoreState">restoreState</a></b> (<i>self</i>, QByteArray <i>state</i>)</li><li><div class="fn" />QByteArray <b><a href="qfiledialog.html#saveState">saveState</a></b> (<i>self</i>)</li><li><div class="fn" />QStringList <b><a href="qfiledialog.html#selectedFiles">selectedFiles</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qfiledialog.html#selectedFilter">selectedFilter</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qfiledialog.html#selectedNameFilter">selectedNameFilter</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#selectFile">selectFile</a></b> (<i>self</i>, QString <i>filename</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#selectFilter">selectFilter</a></b> (<i>self</i>, QString <i>filter</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#selectNameFilter">selectNameFilter</a></b> (<i>self</i>, QString <i>filter</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setAcceptMode">setAcceptMode</a></b> (<i>self</i>, AcceptMode <i>mode</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setConfirmOverwrite">setConfirmOverwrite</a></b> (<i>self</i>, bool <i>enabled</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setDefaultSuffix">setDefaultSuffix</a></b> (<i>self</i>, QString <i>suffix</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setDirectory">setDirectory</a></b> (<i>self</i>, QString <i>directory</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setDirectory-2">setDirectory</a></b> (<i>self</i>, QDir <i>adirectory</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setFileMode">setFileMode</a></b> (<i>self</i>, FileMode <i>mode</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setFilter">setFilter</a></b> (<i>self</i>, QString <i>filter</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setFilter-2">setFilter</a></b> (<i>self</i>, QDir.Filters <i>filters</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setFilters">setFilters</a></b> (<i>self</i>, QStringList <i>filters</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setHistory">setHistory</a></b> (<i>self</i>, QStringList <i>paths</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setIconProvider">setIconProvider</a></b> (<i>self</i>, QFileIconProvider <i>provider</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setItemDelegate">setItemDelegate</a></b> (<i>self</i>, QAbstractItemDelegate <i>delegate</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setLabelText">setLabelText</a></b> (<i>self</i>, DialogLabel <i>label</i>, QString <i>text</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setNameFilter">setNameFilter</a></b> (<i>self</i>, QString <i>filter</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setNameFilterDetailsVisible">setNameFilterDetailsVisible</a></b> (<i>self</i>, bool <i>enabled</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setNameFilters">setNameFilters</a></b> (<i>self</i>, QStringList <i>filters</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setOption">setOption</a></b> (<i>self</i>, Option <i>option</i>, bool <i>on</i> = True)</li><li><div class="fn" /><b><a href="qfiledialog.html#setOptions">setOptions</a></b> (<i>self</i>, Options <i>options</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setProxyModel">setProxyModel</a></b> (<i>self</i>, QAbstractProxyModel <i>model</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setReadOnly">setReadOnly</a></b> (<i>self</i>, bool <i>enabled</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setResolveSymlinks">setResolveSymlinks</a></b> (<i>self</i>, bool <i>enabled</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setSidebarUrls">setSidebarUrls</a></b> (<i>self</i>, list-of-QUrl <i>urls</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setViewMode">setViewMode</a></b> (<i>self</i>, ViewMode <i>mode</i>)</li><li><div class="fn" /><b><a href="qfiledialog.html#setVisible">setVisible</a></b> (<i>self</i>, bool <i>visible</i>)</li><li><div class="fn" />list-of-QUrl <b><a href="qfiledialog.html#sidebarUrls">sidebarUrls</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qfiledialog.html#testOption">testOption</a></b> (<i>self</i>, Option <i>option</i>)</li><li><div class="fn" />ViewMode <b><a href="qfiledialog.html#viewMode">viewMode</a></b> (<i>self</i>)</li></ul><h3>Static Methods</h3><ul><li><div class="fn" />QString <b><a href="qfiledialog.html#getExistingDirectory">getExistingDirectory</a></b> (QWidget <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), Options <i>options</i> = QFileDialog.ShowDirsOnly)</li><li><div class="fn" />QString <b><a href="qfiledialog.html#getOpenFileName">getOpenFileName</a></b> (QWidget <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), Options <i>options</i> = 0)</li><li><div class="fn" />QString <b><a href="qfiledialog.html#getOpenFileName-2">getOpenFileName</a></b> (QWidget <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), QString <i>selectedFilter</i> = None, Options <i>options</i> = 0)</li><li><div class="fn" />(QString, QString) <b><a href="qfiledialog.html#getOpenFileNameAndFilter">getOpenFileNameAndFilter</a></b> (QWidget <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), QString <i>initialFilter</i> = QString(), Options <i>options</i> = 0)</li><li><div class="fn" />QStringList <b><a href="qfiledialog.html#getOpenFileNames">getOpenFileNames</a></b> (QWidget <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), Options <i>options</i> = 0)</li><li><div class="fn" />QStringList <b><a href="qfiledialog.html#getOpenFileNames-2">getOpenFileNames</a></b> (QWidget <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), QString <i>selectedFilter</i> = None, Options <i>options</i> = 0)</li><li><div class="fn" />(QString, QString) <b><a href="qfiledialog.html#getOpenFileNamesAndFilter">getOpenFileNamesAndFilter</a></b> (QWidget <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), QString <i>initialFilter</i> = QString(), Options <i>options</i> = 0)</li><li><div class="fn" />QString <b><a href="qfiledialog.html#getSaveFileName">getSaveFileName</a></b> (QWidget <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), Options <i>options</i> = 0)</li><li><div class="fn" />QString <b><a href="qfiledialog.html#getSaveFileName-2">getSaveFileName</a></b> (QWidget <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), QString <i>selectedFilter</i> = None, Options <i>options</i> = 0)</li><li><div class="fn" />(QString, QString) <b><a href="qfiledialog.html#getSaveFileNameAndFilter">getSaveFileNameAndFilter</a></b> (QWidget <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), QString <i>initialFilter</i> = QString(), Options <i>options</i> = 0)</li></ul><h3>Qt Signals</h3><ul><li><div class="fn" />void <b><a href="qfiledialog.html#currentChanged">currentChanged</a></b> (const QString&)</li><li><div class="fn" />void <b><a href="qfiledialog.html#directoryEntered">directoryEntered</a></b> (const QString&)</li><li><div class="fn" />void <b><a href="qfiledialog.html#fileSelected">fileSelected</a></b> (const QString&)</li><li><div class="fn" />void <b><a href="qfiledialog.html#filesSelected">filesSelected</a></b> (const QStringList&)</li><li><div class="fn" />void <b><a href="qfiledialog.html#filterSelected">filterSelected</a></b> (const QString&)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>The QFileDialog class provides a dialog that allow users to select files or directories.</p> <p>The QFileDialog class enables a user to traverse the file system in order to select one or many files or a directory.</p> <p>The easiest way to create a QFileDialog is to use the static functions. On Windows, Mac OS X, KDE and GNOME, these static functions will call the native file dialog when possible.</p> <pre class="cpp"> fileName <span class="operator">=</span> <span class="type">QFileDialog</span><span class="operator">.</span><a href="qfiledialog.html#getOpenFileName">getOpenFileName</a>(<span class="keyword">this</span><span class="operator">,</span> tr(<span class="string">"Open Image"</span>)<span class="operator">,</span> <span class="string">"/home/jana"</span><span class="operator">,</span> tr(<span class="string">"Image Files (*.png *.jpg *.bmp)"</span>)); </pre> <p>In the above example, a modal QFileDialog is created using a static function. The dialog initially displays the contents of the "/home/jana" directory, and displays files matching the patterns given in the string "Image Files (*.png *.jpg *.bmp)". The parent of the file dialog is set to <i>this</i>, and the window title is set to "Open Image".</p> <p>If you want to use multiple filters, separate each one with <i>two</i> semicolons. For example:</p> <pre class="cpp"> <span class="string">"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"</span> </pre> <p>You can create your own QFileDialog without using the static functions. By calling <a href="qfiledialog.html#fileMode-prop">setFileMode</a>(), you can specify what the user must select in the dialog:</p> <pre class="cpp"> <span class="type">QFileDialog</span> dialog(<span class="keyword">this</span>); dialog<span class="operator">.</span><a href="qfiledialog.html#fileMode-prop">setFileMode</a>(<span class="type">QFileDialog</span><span class="operator">.</span>AnyFile); </pre> <p>In the above example, the mode of the file dialog is set to <a href="qfiledialog.html#FileMode-enum">AnyFile</a>, meaning that the user can select any file, or even specify a file that doesn't exist. This mode is useful for creating a "Save As" file dialog. Use <a href="qfiledialog.html#FileMode-enum">ExistingFile</a> if the user must select an existing file, or <a href="qfiledialog.html#FileMode-enum">Directory</a> if only a directory may be selected. See the <a href="qfiledialog.html#FileMode-enum">QFileDialog.FileMode</a> enum for the complete list of modes.</p> <p>The <a href="qfiledialog.html#fileMode-prop">fileMode</a> property contains the mode of operation for the dialog; this indicates what types of objects the user is expected to select. Use <a href="qfiledialog.html#setNameFilter">setNameFilter</a>() to set the dialog's file filter. For example:</p> <pre class="cpp"> dialog<span class="operator">.</span><a href="qfiledialog.html#setNameFilter">setNameFilter</a>(tr(<span class="string">"Images (*.png *.xpm *.jpg)"</span>)); </pre> <p>In the above example, the filter is set to <tt>"Images (*.png *.xpm *.jpg)"</tt>, this means that only files with the extension <tt>png</tt>, <tt>xpm</tt>, or <tt>jpg</tt> will be shown in the QFileDialog. You can apply several filters by using <a href="qfiledialog.html#setNameFilters">setNameFilters</a>(). Use <a href="qfiledialog.html#selectNameFilter">selectNameFilter</a>() to select one of the filters you've given as the file dialog's default filter.</p> <p>The file dialog has two view modes: <a href="qfiledialog.html#ViewMode-enum">List</a> and <a href="qfiledialog.html#ViewMode-enum">Detail</a>. <a href="qfiledialog.html#ViewMode-enum">List</a> presents the contents of the current directory as a list of file and directory names. <a href="qfiledialog.html#ViewMode-enum">Detail</a> also displays a list of file and directory names, but provides additional information alongside each name, such as the file size and modification date. Set the mode with <a href="qfiledialog.html#viewMode-prop">setViewMode</a>():</p> <pre class="cpp"> dialog<span class="operator">.</span><a href="qfiledialog.html#viewMode-prop">setViewMode</a>(<span class="type">QFileDialog</span><span class="operator">.</span>Detail); </pre> <p>The last important function you will need to use when creating your own file dialog is <a href="qfiledialog.html#selectedFiles">selectedFiles</a>().</p> <pre class="cpp"> <span class="type"><a href="qstringlist.html">QStringList</a></span> fileNames; <span class="keyword">if</span> (dialog<span class="operator">.</span>exec()) fileNames <span class="operator">=</span> dialog<span class="operator">.</span><a href="qfiledialog.html#selectedFiles">selectedFiles</a>(); </pre> <p>In the above example, a modal file dialog is created and shown. If the user clicked OK, the file they selected is put in <tt>fileName</tt>.</p> <p>The dialog's working directory can be set with <a href="qfiledialog.html#setDirectory">setDirectory</a>(). Each file in the current directory can be selected using the <a href="qfiledialog.html#selectFile">selectFile</a>() function.</p> <p>The <a href="dialogs-standarddialogs.html">Standard Dialogs</a> example shows how to use QFileDialog as well as other built-in Qt dialogs.</p> <hr /><h2>Type Documentation</h2><h3 class="fn"><a name="AcceptMode-enum" />QFileDialog.AcceptMode</h3><table class="valuelist"> <tr> <th class="tblConst">Constant</th> <th class="tblVal">Value</th> </tr> <tr> <td class="topAlign"><tt>QFileDialog.AcceptOpen</tt></td> <td class="topAlign"><tt>0</tt></td> </tr> <tr> <td class="topAlign"><tt>QFileDialog.AcceptSave</tt></td> <td class="topAlign"><tt>1</tt></td> </tr> </table> <h3 class="fn"><a name="DialogLabel-enum" />QFileDialog.DialogLabel</h3><table class="valuelist"> <tr> <th class="tblConst">Constant</th> <th class="tblVal">Value</th> </tr> <tr> <td class="topAlign"><tt>QFileDialog.LookIn</tt></td> <td class="topAlign"><tt>0</tt></td> </tr> <tr> <td class="topAlign"><tt>QFileDialog.FileName</tt></td> <td class="topAlign"><tt>1</tt></td> </tr> <tr> <td class="topAlign"><tt>QFileDialog.FileType</tt></td> <td class="topAlign"><tt>2</tt></td> </tr> <tr> <td class="topAlign"><tt>QFileDialog.Accept</tt></td> <td class="topAlign"><tt>3</tt></td> </tr> <tr> <td class="topAlign"><tt>QFileDialog.Reject</tt></td> <td class="topAlign"><tt>4</tt></td> </tr> </table> <h3 class="fn"><a name="FileMode-enum" />QFileDialog.FileMode</h3><p>This enum is used to indicate what the user may select in the file dialog; i.e. what the dialog will return if the user clicks OK.</p> <table class="valuelist"> <tr class="odd" valign="top"> <th class="tblConst">Constant</th> <th class="tblval">Value</th> <th class="tbldscr">Description</th> </tr> <tr> <td class="topAlign"><tt>QFileDialog.AnyFile</tt></td> <td class="topAlign"><tt>0</tt></td> <td class="topAlign">The name of a file, whether it exists or not.</td> </tr> <tr> <td class="topAlign"><tt>QFileDialog.ExistingFile</tt></td> <td class="topAlign"><tt>1</tt></td> <td class="topAlign">The name of a single existing file.</td> </tr> <tr> <td class="topAlign"><tt>QFileDialog.Directory</tt></td> <td class="topAlign"><tt>2</tt></td> <td class="topAlign">The name of a directory. Both files and directories are displayed.</td> </tr> <tr> <td class="topAlign"><tt>QFileDialog.ExistingFiles</tt></td> <td class="topAlign"><tt>3</tt></td> <td class="topAlign">The names of zero or more existing files.</td> </tr> </table> <p>This value is obsolete since Qt 4.5:</p> <table class="valuelist"> <tr class="even" valign="top"> <th class="tblConst">Constant</th> <th class="tblval">Value</th> <th class="tbldscr">Description</th> </tr> <tr> <td class="topAlign"><tt>QFileDialog.DirectoryOnly</tt></td> <td class="topAlign"><tt>4</tt></td> <td class="topAlign">Use <tt>Directory</tt> and setOption(<a href="qfiledialog.html#Option-enum">ShowDirsOnly</a>, true) instead.</td> </tr> </table> <p><b>See also</b> <a href="qfiledialog.html#fileMode-prop">setFileMode</a>().</p> <h3 class="fn"><a name="Option-enum" />QFileDialog.Option</h3><table class="valuelist"> <tr class="odd" valign="top"> <th class="tblConst">Constant</th> <th class="tblval">Value</th> <th class="tbldscr">Description</th> </tr> <tr> <td class="topAlign"><tt>QFileDialog.ShowDirsOnly</tt></td> <td class="topAlign"><tt>0x00000001</tt></td> <td class="topAlign">Only show directories in the file dialog. By default both files and directories are shown. (Valid only in the <a href="qfiledialog.html#FileMode-enum">Directory</a> file mode.)</td> </tr> <tr> <td class="topAlign"><tt>QFileDialog.DontResolveSymlinks</tt></td> <td class="topAlign"><tt>0x00000002</tt></td> <td class="topAlign">Don't resolve symlinks in the file dialog. By default symlinks are resolved.</td> </tr> <tr> <td class="topAlign"> <tt>QFileDialog.DontConfirmOverwrite</tt></td> <td class="topAlign"><tt>0x00000004</tt></td> <td class="topAlign">Don't ask for confirmation if an existing file is selected. By default confirmation is requested.</td> </tr> <tr> <td class="topAlign"><tt>QFileDialog.DontUseNativeDialog</tt></td> <td class="topAlign"><tt>0x00000010</tt></td> <td class="topAlign">Don't use the native file dialog. By default, the native file dialog is used unless you use a subclass of <a href="qfiledialog.html">QFileDialog</a> that contains the <a href="qobject.html#Q_OBJECT">Q_OBJECT</a> macro.</td> </tr> <tr> <td class="topAlign"><tt>QFileDialog.ReadOnly</tt></td> <td class="topAlign"><tt>0x00000020</tt></td> <td class="topAlign">Indicates that the model is readonly.</td> </tr> <tr> <td class="topAlign"> <tt>QFileDialog.HideNameFilterDetails</tt></td> <td class="topAlign"><tt>0x00000040</tt></td> <td class="topAlign">Indicates if the file name filter details are hidden or not.</td> </tr> <tr> <td class="topAlign"><tt>QFileDialog.DontUseSheet</tt></td> <td class="topAlign"><tt>0x00000008</tt></td> <td class="topAlign">In previous versions of Qt, the static functions would create a sheet by default if the static function was given a parent. This is no longer supported and does nothing in Qt 4.5, The static functions will always be an application modal dialog. If you want to use sheets, use <a href="qfiledialog.html#open">QFileDialog.open</a>() instead.</td> </tr> </table> <p>The Options type is a typedef for <a href="qflags.html">QFlags</a><Option>. It stores an OR combination of Option values.</p> <h3 class="fn"><a name="ViewMode-enum" />QFileDialog.ViewMode</h3><p>This enum describes the view mode of the file dialog; i.e. what information about each file will be displayed.</p> <table class="valuelist"> <tr class="odd" valign="top"> <th class="tblConst">Constant</th> <th class="tblval">Value</th> <th class="tbldscr">Description</th> </tr> <tr> <td class="topAlign"><tt>QFileDialog.Detail</tt></td> <td class="topAlign"><tt>0</tt></td> <td class="topAlign">Displays an icon, a name, and details for each item in the directory.</td> </tr> <tr> <td class="topAlign"><tt>QFileDialog.List</tt></td> <td class="topAlign"><tt>1</tt></td> <td class="topAlign">Displays only an icon and a name for each item in the directory.</td> </tr> </table> <p><b>See also</b> <a href="qfiledialog.html#viewMode-prop">setViewMode</a>().</p> <hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QFileDialog" />QFileDialog.__init__ (<i>self</i>, <a href="qwidget.html">QWidget</a> <i>parent</i>, <a href="qt-windowflags.html">Qt.WindowFlags</a> <i>f</i>)</h3><p>The <i>parent</i> argument, if not None, causes <i>self</i> to be owned by Qt instead of PyQt.</p><p>Constructs a file dialog with the given <i>parent</i> and widget <i>flags</i>.</p> <h3 class="fn"><a name="QFileDialog-2" />QFileDialog.__init__ (<i>self</i>, <a href="qwidget.html">QWidget</a> <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString())</h3><p>The <i>parent</i> argument, if not None, causes <i>self</i> to be owned by Qt instead of PyQt.</p><p>Constructs a file dialog with the given <i>parent</i> and <i>caption</i> that initially displays the contents of the specified <i>directory</i>. The contents of the directory are filtered before being shown in the dialog, using a semicolon-separated list of filters specified by <i>filter</i>.</p> <h3 class="fn"><a name="accept" />QFileDialog.accept (<i>self</i>)</h3><p>Reimplemented from <a href="qdialog.html#accept">QDialog.accept</a>().</p> <h3 class="fn"><a name="acceptMode" /><a href="qfiledialog.html#AcceptMode-enum">AcceptMode</a> QFileDialog.acceptMode (<i>self</i>)</h3><h3 class="fn"><a name="changeEvent" />QFileDialog.changeEvent (<i>self</i>, <a href="qevent.html">QEvent</a> <i>e</i>)</h3><p>Reimplemented from <a href="qwidget.html#changeEvent">QWidget.changeEvent</a>().</p> <h3 class="fn"><a name="confirmOverwrite" />bool QFileDialog.confirmOverwrite (<i>self</i>)</h3><h3 class="fn"><a name="defaultSuffix" />QString QFileDialog.defaultSuffix (<i>self</i>)</h3><h3 class="fn"><a name="directory" /><a href="qdir.html">QDir</a> QFileDialog.directory (<i>self</i>)</h3><p>Returns the directory currently being displayed in the dialog.</p> <p><b>See also</b> <a href="qfiledialog.html#setDirectory">setDirectory</a>().</p> <h3 class="fn"><a name="done" />QFileDialog.done (<i>self</i>, int <i>result</i>)</h3><p>Reimplemented from <a href="qdialog.html#done">QDialog.done</a>().</p> <h3 class="fn"><a name="fileMode" /><a href="qfiledialog.html#FileMode-enum">FileMode</a> QFileDialog.fileMode (<i>self</i>)</h3><h3 class="fn"><a name="filter" /><a href="qdir-filters.html">QDir.Filters</a> QFileDialog.filter (<i>self</i>)</h3><p>Returns the filter that is used when displaying files.</p> <p>This function was introduced in Qt 4.4.</p> <p><b>See also</b> <a href="qfiledialog.html#setFilter">setFilter</a>().</p> <h3 class="fn"><a name="filters" />QStringList QFileDialog.filters (<i>self</i>)</h3><h3 class="fn"><a name="getExistingDirectory" />QString QFileDialog.getExistingDirectory (<a href="qwidget.html">QWidget</a> <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), <a href="qfiledialog-options.html">Options</a> <i>options</i> = QFileDialog.ShowDirsOnly)</h3><p>This is a convenience static function that will return an existing directory selected by the user.</p> <pre class="cpp"> <span class="type"><a href="qstring.html">QString</a></span> dir <span class="operator">=</span> <span class="type"><a href="qfiledialog.html">QFileDialog</a></span><span class="operator">.</span>getExistingDirectory(<span class="keyword">this</span><span class="operator">,</span> tr(<span class="string">"Open Directory"</span>)<span class="operator">,</span> <span class="string">"/home"</span><span class="operator">,</span> <span class="type"><a href="qfiledialog.html">QFileDialog</a></span><span class="operator">.</span>ShowDirsOnly <span class="operator">|</span> <span class="type"><a href="qfiledialog.html">QFileDialog</a></span><span class="operator">.</span>DontResolveSymlinks); </pre> <p>This function creates a modal file dialog with the given <i>parent</i> widget. If <i>parent</i> is not 0, the dialog will be shown centered over the parent widget.</p> <p>The dialog's working directory is set to <i>dir</i>, and the caption is set to <i>caption</i>. Either of these may be an empty string in which case the current directory and a default caption will be used respectively.</p> <p>The <i>options</i> argument holds various options about how to run the dialog, see the <a href="qfiledialog.html#Option-enum">QFileDialog.Option</a> enum for more information on the flags you can pass. To ensure a native file dialog, <a href="qfiledialog.html#Option-enum">ShowDirsOnly</a> must be set.</p> <p>On Windows, Mac OS X and Symbian^3, this static function will use the native file dialog and not a <a href="qfiledialog.html">QFileDialog</a>. On Windows CE, if the device has no native file dialog, a <a href="qfiledialog.html">QFileDialog</a> will be used.</p> <p>On Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if <tt>/usr/tmp</tt> is a symlink to <tt>/var/tmp</tt>, the file dialog will change to <tt>/var/tmp</tt> after entering <tt>/usr/tmp</tt>. If <i>options</i> includes <a href="qfiledialog.html#Option-enum">DontResolveSymlinks</a>, the file dialog will treat symlinks as regular directories.</p> <p>On Windows the dialog will spin a blocking modal event loop that will not dispatch any QTimers, and if <i>parent</i> is not 0 then it will position the dialog just below the parent's title bar.</p> <p>On Symbian^3 the <i>options</i> parameter is only used to define if the native file dialog is used.</p> <p><b>Warning:</b> Do not delete <i>parent</i> during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of the <a href="qfiledialog.html">QFileDialog</a> constructors.</p> <p><b>See also</b> <a href="qfiledialog.html#getOpenFileName">getOpenFileName</a>(), <a href="qfiledialog.html#getOpenFileNames">getOpenFileNames</a>(), and <a href="qfiledialog.html#getSaveFileName">getSaveFileName</a>().</p> <h3 class="fn"><a name="getOpenFileName" />QString QFileDialog.getOpenFileName (<a href="qwidget.html">QWidget</a> <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), <a href="qfiledialog-options.html">Options</a> <i>options</i> = 0)</h3><p>This is a convenience static function that returns an existing file selected by the user. If the user presses Cancel, it returns a null string.</p> <pre class="cpp"> <span class="type"><a href="qstring.html">QString</a></span> fileName <span class="operator">=</span> <span class="type"><a href="qfiledialog.html">QFileDialog</a></span><span class="operator">.</span>getOpenFileName(<span class="keyword">this</span><span class="operator">,</span> tr(<span class="string">"Open File"</span>)<span class="operator">,</span> <span class="string">"/home"</span><span class="operator">,</span> tr(<span class="string">"Images (*.png *.xpm *.jpg)"</span>)); </pre> <p>The function creates a modal file dialog with the given <i>parent</i> widget. If <i>parent</i> is not 0, the dialog will be shown centered over the parent widget.</p> <p>The file dialog's working directory will be set to <i>dir</i>. If <i>dir</i> includes a file name, the file will be selected. Only files that match the given <i>filter</i> are shown. The filter selected is set to <i>selectedFilter</i>. The parameters <i>dir</i>, <i>selectedFilter</i>, and <i>filter</i> may be empty strings. If you want multiple filters, separate them with ';;', for example:</p> <pre class="cpp"> <span class="string">"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"</span> </pre> <p>The <i>options</i> argument holds various options about how to run the dialog, see the <a href="qfiledialog.html#Option-enum">QFileDialog.Option</a> enum for more information on the flags you can pass.</p> <p>The dialog's caption is set to <i>caption</i>. If <i>caption</i> is not specified then a default caption will be used.</p> <p>On Windows, Mac OS X and Symbian^3, this static function will use the native file dialog and not a <a href="qfiledialog.html">QFileDialog</a>.</p> <p>On Windows the dialog will spin a blocking modal event loop that will not dispatch any QTimers, and if <i>parent</i> is not 0 then it will position the dialog just below the parent's title bar.</p> <p>On Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if <tt>/usr/tmp</tt> is a symlink to <tt>/var/tmp</tt>, the file dialog will change to <tt>/var/tmp</tt> after entering <tt>/usr/tmp</tt>. If <i>options</i> includes <a href="qfiledialog.html#Option-enum">DontResolveSymlinks</a>, the file dialog will treat symlinks as regular directories.</p> <p>On Symbian^3 the parameter <i>selectedFilter</i> has no meaning and the <i>options</i> parameter is only used to define if the native file dialog is used.</p> <p><b>Warning:</b> Do not delete <i>parent</i> during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of the <a href="qfiledialog.html">QFileDialog</a> constructors.</p> <p><b>See also</b> <a href="qfiledialog.html#getOpenFileNames">getOpenFileNames</a>(), <a href="qfiledialog.html#getSaveFileName">getSaveFileName</a>(), and <a href="qfiledialog.html#getExistingDirectory">getExistingDirectory</a>().</p> <h3 class="fn"><a name="getOpenFileName-2" />QString QFileDialog.getOpenFileName (<a href="qwidget.html">QWidget</a> <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), QString <i>selectedFilter</i> = None, <a href="qfiledialog-options.html">Options</a> <i>options</i> = 0)</h3><h3 class="fn"><a name="getOpenFileNameAndFilter" />(QString, QString) QFileDialog.getOpenFileNameAndFilter (<a href="qwidget.html">QWidget</a> <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), QString <i>initialFilter</i> = QString(), <a href="qfiledialog-options.html">Options</a> <i>options</i> = 0)</h3><h3 class="fn"><a name="getOpenFileNames" />QStringList QFileDialog.getOpenFileNames (<a href="qwidget.html">QWidget</a> <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), <a href="qfiledialog-options.html">Options</a> <i>options</i> = 0)</h3><p>This is a convenience static function that will return one or more existing files selected by the user.</p> <pre class="cpp"> <span class="type"><a href="qstringlist.html">QStringList</a></span> files <span class="operator">=</span> <span class="type"><a href="qfiledialog.html">QFileDialog</a></span><span class="operator">.</span>getOpenFileNames( <span class="keyword">this</span><span class="operator">,</span> <span class="string">"Select one or more files to open"</span><span class="operator">,</span> <span class="string">"/home"</span><span class="operator">,</span> <span class="string">"Images (*.png *.xpm *.jpg)"</span>); </pre> <p>This function creates a modal file dialog with the given <i>parent</i> widget. If <i>parent</i> is not 0, the dialog will be shown centered over the parent widget.</p> <p>The file dialog's working directory will be set to <i>dir</i>. If <i>dir</i> includes a file name, the file will be selected. The filter is set to <i>filter</i> so that only those files which match the filter are shown. The filter selected is set to <i>selectedFilter</i>. The parameters <i>dir</i>, <i>selectedFilter</i> and <i>filter</i> may be empty strings. If you need multiple filters, separate them with ';;', for instance:</p> <pre class="cpp"> <span class="string">"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"</span> </pre> <p>The dialog's caption is set to <i>caption</i>. If <i>caption</i> is not specified then a default caption will be used.</p> <p>On Windows, Mac OS X and Symbian^3, this static function will use the native file dialog and not a <a href="qfiledialog.html">QFileDialog</a>.</p> <p>On Windows the dialog will spin a blocking modal event loop that will not dispatch any QTimers, and if <i>parent</i> is not 0 then it will position the dialog just below the parent's title bar.</p> <p>On Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if <tt>/usr/tmp</tt> is a symlink to <tt>/var/tmp</tt>, the file dialog will change to <tt>/var/tmp</tt> after entering <tt>/usr/tmp</tt>. The <i>options</i> argument holds various options about how to run the dialog, see the <a href="qfiledialog.html#Option-enum">QFileDialog.Option</a> enum for more information on the flags you can pass.</p> <p><b>Note:</b> If you want to iterate over the list of files, you should iterate over a copy. For example:</p> <pre class="cpp"> <span class="type"><a href="qstringlist.html">QStringList</a></span> list <span class="operator">=</span> files; <span class="type"><a href="qstringlist.html">QStringList</a></span><span class="operator">.</span>Iterator it <span class="operator">=</span> list<span class="operator">.</span>begin(); <span class="keyword">while</span>(it <span class="operator">!</span><span class="operator">=</span> list<span class="operator">.</span>end()) { myProcessing(<span class="operator">*</span>it); <span class="operator">+</span><span class="operator">+</span>it; } </pre> <p>On Symbian^3 the parameter <i>selectedFilter</i> has no meaning and the <i>options</i> parameter is only used to define if the native file dialog is used. On Symbian^3, this function can only return a single filename.</p> <p><b>Warning:</b> Do not delete <i>parent</i> during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of the <a href="qfiledialog.html">QFileDialog</a> constructors.</p> <p><b>See also</b> <a href="qfiledialog.html#getOpenFileName">getOpenFileName</a>(), <a href="qfiledialog.html#getSaveFileName">getSaveFileName</a>(), and <a href="qfiledialog.html#getExistingDirectory">getExistingDirectory</a>().</p> <h3 class="fn"><a name="getOpenFileNames-2" />QStringList QFileDialog.getOpenFileNames (<a href="qwidget.html">QWidget</a> <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), QString <i>selectedFilter</i> = None, <a href="qfiledialog-options.html">Options</a> <i>options</i> = 0)</h3><h3 class="fn"><a name="getOpenFileNamesAndFilter" />(QString, QString) QFileDialog.getOpenFileNamesAndFilter (<a href="qwidget.html">QWidget</a> <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), QString <i>initialFilter</i> = QString(), <a href="qfiledialog-options.html">Options</a> <i>options</i> = 0)</h3><h3 class="fn"><a name="getSaveFileName" />QString QFileDialog.getSaveFileName (<a href="qwidget.html">QWidget</a> <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), <a href="qfiledialog-options.html">Options</a> <i>options</i> = 0)</h3><p>This is a convenience static function that will return a file name selected by the user. The file does not have to exist.</p> <p>It creates a modal file dialog with the given <i>parent</i> widget. If <i>parent</i> is not 0, the dialog will be shown centered over the parent widget.</p> <pre class="cpp"> <span class="type"><a href="qstring.html">QString</a></span> fileName <span class="operator">=</span> <span class="type"><a href="qfiledialog.html">QFileDialog</a></span><span class="operator">.</span>getSaveFileName(<span class="keyword">this</span><span class="operator">,</span> tr(<span class="string">"Save File"</span>)<span class="operator">,</span> <span class="string">"/home/jana/untitled.png"</span><span class="operator">,</span> tr(<span class="string">"Images (*.png *.xpm *.jpg)"</span>)); </pre> <p>The file dialog's working directory will be set to <i>dir</i>. If <i>dir</i> includes a file name, the file will be selected. Only files that match the <i>filter</i> are shown. The filter selected is set to <i>selectedFilter</i>. The parameters <i>dir</i>, <i>selectedFilter</i>, and <i>filter</i> may be empty strings. Multiple filters are separated with ';;'. For instance:</p> <pre class="cpp"> <span class="string">"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"</span> </pre> <p>The <i>options</i> argument holds various options about how to run the dialog, see the <a href="qfiledialog.html#Option-enum">QFileDialog.Option</a> enum for more information on the flags you can pass.</p> <p>The default filter can be chosen by setting <i>selectedFilter</i> to the desired value.</p> <p>The dialog's caption is set to <i>caption</i>. If <i>caption</i> is not specified, a default caption will be used.</p> <p>On Windows, Mac OS X and Symbian^3, this static function will use the native file dialog and not a <a href="qfiledialog.html">QFileDialog</a>.</p> <p>On Windows the dialog will spin a blocking modal event loop that will not dispatch any QTimers, and if <i>parent</i> is not 0 then it will position the dialog just below the parent's title bar. On Mac OS X, with its native file dialog, the filter argument is ignored.</p> <p>On Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if <tt>/usr/tmp</tt> is a symlink to <tt>/var/tmp</tt>, the file dialog will change to <tt>/var/tmp</tt> after entering <tt>/usr/tmp</tt>. If <i>options</i> includes <a href="qfiledialog.html#Option-enum">DontResolveSymlinks</a> the file dialog will treat symlinks as regular directories.</p> <p>On Symbian^3 the parameters <i>filter</i> and <i>selectedFilter</i> have no meaning. The <i>options</i> parameter is only used to define if the native file dialog is used.</p> <p><b>Warning:</b> Do not delete <i>parent</i> during the execution of the dialog. If you want to do this, you should create the dialog yourself using one of the <a href="qfiledialog.html">QFileDialog</a> constructors.</p> <p><b>See also</b> <a href="qfiledialog.html#getOpenFileName">getOpenFileName</a>(), <a href="qfiledialog.html#getOpenFileNames">getOpenFileNames</a>(), and <a href="qfiledialog.html#getExistingDirectory">getExistingDirectory</a>().</p> <h3 class="fn"><a name="getSaveFileName-2" />QString QFileDialog.getSaveFileName (<a href="qwidget.html">QWidget</a> <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), QString <i>selectedFilter</i> = None, <a href="qfiledialog-options.html">Options</a> <i>options</i> = 0)</h3><h3 class="fn"><a name="getSaveFileNameAndFilter" />(QString, QString) QFileDialog.getSaveFileNameAndFilter (<a href="qwidget.html">QWidget</a> <i>parent</i> = None, QString <i>caption</i> = QString(), QString <i>directory</i> = QString(), QString <i>filter</i> = QString(), QString <i>initialFilter</i> = QString(), <a href="qfiledialog-options.html">Options</a> <i>options</i> = 0)</h3><h3 class="fn"><a name="history" />QStringList QFileDialog.history (<i>self</i>)</h3><p>Returns the browsing history of the filedialog as a list of paths.</p> <p><b>See also</b> <a href="qfiledialog.html#setHistory">setHistory</a>().</p> <h3 class="fn"><a name="iconProvider" /><a href="qfileiconprovider.html">QFileIconProvider</a> QFileDialog.iconProvider (<i>self</i>)</h3><p>Returns the icon provider used by the filedialog.</p> <p><b>See also</b> <a href="qfiledialog.html#setIconProvider">setIconProvider</a>().</p> <h3 class="fn"><a name="isNameFilterDetailsVisible" />bool QFileDialog.isNameFilterDetailsVisible (<i>self</i>)</h3><h3 class="fn"><a name="isReadOnly" />bool QFileDialog.isReadOnly (<i>self</i>)</h3><h3 class="fn"><a name="itemDelegate" /><a href="qabstractitemdelegate.html">QAbstractItemDelegate</a> QFileDialog.itemDelegate (<i>self</i>)</h3><p>Returns the item delegate used to render the items in the views in the filedialog.</p> <p><b>See also</b> <a href="qfiledialog.html#setItemDelegate">setItemDelegate</a>().</p> <h3 class="fn"><a name="labelText" />QString QFileDialog.labelText (<i>self</i>, <a href="qfiledialog.html#DialogLabel-enum">DialogLabel</a> <i>label</i>)</h3><p>Returns the text shown in the filedialog in the specified <i>label</i>.</p> <p><b>See also</b> <a href="qfiledialog.html#setLabelText">setLabelText</a>().</p> <h3 class="fn"><a name="nameFilters" />QStringList QFileDialog.nameFilters (<i>self</i>)</h3><p>Returns the file type filters that are in operation on this file dialog.</p> <p>This function was introduced in Qt 4.4.</p> <p><b>See also</b> <a href="qfiledialog.html#setNameFilters">setNameFilters</a>().</p> <h3 class="fn"><a name="open" />QFileDialog.open (<i>self</i>)</h3><p>This is an overloaded function.</p> <p>This function connects one of its signals to the slot specified by <i>receiver</i> and <i>member</i>. The specific signal depends is <a href="qfiledialog.html#filesSelected">filesSelected</a>() if <a href="qfiledialog.html#fileMode-prop">fileMode</a> is <a href="qfiledialog.html#FileMode-enum">ExistingFiles</a> and <a href="qfiledialog.html#fileSelected">fileSelected</a>() if <a href="qfiledialog.html#fileMode-prop">fileMode</a> is anything else.</p> <p>The signal will be disconnected from the slot when the dialog is closed.</p> <p>This function was introduced in Qt 4.5.</p> <h3 class="fn"><a name="open-2" />QFileDialog.open (<i>self</i>, <a href="qobject.html">QObject</a> <i>receiver</i>, SLOT()SLOT() <i>member</i>)</h3><h3 class="fn"><a name="open-3" />QFileDialog.open (<i>self</i>, callable <i>receiver</i>)</h3><h3 class="fn"><a name="options" /><a href="qfiledialog-options.html">Options</a> QFileDialog.options (<i>self</i>)</h3><h3 class="fn"><a name="proxyModel" /><a href="qabstractproxymodel.html">QAbstractProxyModel</a> QFileDialog.proxyModel (<i>self</i>)</h3><p>Returns the proxy model used by the file dialog. By default no proxy is set.</p> <p><b>See also</b> <a href="qfiledialog.html#setProxyModel">setProxyModel</a>().</p> <h3 class="fn"><a name="resolveSymlinks" />bool QFileDialog.resolveSymlinks (<i>self</i>)</h3><h3 class="fn"><a name="restoreState" />bool QFileDialog.restoreState (<i>self</i>, <a href="qbytearray.html">QByteArray</a> <i>state</i>)</h3><p>Restores the dialogs's layout, history and current directory to the <i>state</i> specified.</p> <p>Typically this is used in conjunction with <a href="qsettings.html">QSettings</a> to restore the size from a past session.</p> <p>Returns false if there are errors</p> <p>This function was introduced in Qt 4.3.</p> <h3 class="fn"><a name="saveState" /><a href="qbytearray.html">QByteArray</a> QFileDialog.saveState (<i>self</i>)</h3><p>Saves the state of the dialog's layout, history and current directory.</p> <p>Typically this is used in conjunction with <a href="qsettings.html">QSettings</a> to remember the size for a future session. A version number is stored as part of the data.</p> <p>This function was introduced in Qt 4.3.</p> <h3 class="fn"><a name="selectedFiles" />QStringList QFileDialog.selectedFiles (<i>self</i>)</h3><p>Returns a list of strings containing the absolute paths of the selected files in the dialog. If no files are selected, or the mode is not <a href="qfiledialog.html#FileMode-enum">ExistingFiles</a> or <a href="qfiledialog.html#FileMode-enum">ExistingFile</a>, selectedFiles() contains the current path in the viewport.</p> <p><b>See also</b> <a href="qfiledialog.html#selectedNameFilter">selectedNameFilter</a>() and <a href="qfiledialog.html#selectFile">selectFile</a>().</p> <h3 class="fn"><a name="selectedFilter" />QString QFileDialog.selectedFilter (<i>self</i>)</h3><h3 class="fn"><a name="selectedNameFilter" />QString QFileDialog.selectedNameFilter (<i>self</i>)</h3><p>Returns the filter that the user selected in the file dialog.</p> <p>This function was introduced in Qt 4.4.</p> <p><b>See also</b> <a href="qfiledialog.html#selectedFiles">selectedFiles</a>().</p> <h3 class="fn"><a name="selectFile" />QFileDialog.selectFile (<i>self</i>, QString <i>filename</i>)</h3><p>Selects the given <i>filename</i> in the file dialog.</p> <p><b>See also</b> <a href="qfiledialog.html#selectedFiles">selectedFiles</a>().</p> <h3 class="fn"><a name="selectFilter" />QFileDialog.selectFilter (<i>self</i>, QString <i>filter</i>)</h3><h3 class="fn"><a name="selectNameFilter" />QFileDialog.selectNameFilter (<i>self</i>, QString <i>filter</i>)</h3><p>Sets the current file type <i>filter</i>. Multiple filters can be passed in <i>filter</i> by separating them with semicolons or spaces.</p> <p>This function was introduced in Qt 4.4.</p> <p><b>See also</b> <a href="qfiledialog.html#setNameFilter">setNameFilter</a>(), <a href="qfiledialog.html#setNameFilters">setNameFilters</a>(), and <a href="qfiledialog.html#selectedNameFilter">selectedNameFilter</a>().</p> <h3 class="fn"><a name="setAcceptMode" />QFileDialog.setAcceptMode (<i>self</i>, <a href="qfiledialog.html#AcceptMode-enum">AcceptMode</a> <i>mode</i>)</h3><h3 class="fn"><a name="setConfirmOverwrite" />QFileDialog.setConfirmOverwrite (<i>self</i>, bool <i>enabled</i>)</h3><h3 class="fn"><a name="setDefaultSuffix" />QFileDialog.setDefaultSuffix (<i>self</i>, QString <i>suffix</i>)</h3><h3 class="fn"><a name="setDirectory" />QFileDialog.setDirectory (<i>self</i>, QString <i>directory</i>)</h3><p>Sets the file dialog's current <i>directory</i>.</p> <p><b>See also</b> <a href="qfiledialog.html#directory">directory</a>().</p> <h3 class="fn"><a name="setDirectory-2" />QFileDialog.setDirectory (<i>self</i>, <a href="qdir.html">QDir</a> <i>adirectory</i>)</h3><p>This is an overloaded function.</p> <h3 class="fn"><a name="setFileMode" />QFileDialog.setFileMode (<i>self</i>, <a href="qfiledialog.html#FileMode-enum">FileMode</a> <i>mode</i>)</h3><h3 class="fn"><a name="setFilter" />QFileDialog.setFilter (<i>self</i>, QString <i>filter</i>)</h3><p>Sets the filter used by the model to <i>filters</i>. The filter is used to specify the kind of files that should be shown.</p> <p>This function was introduced in Qt 4.4.</p> <p><b>See also</b> <a href="qfiledialog.html#filter">filter</a>().</p> <h3 class="fn"><a name="setFilter-2" />QFileDialog.setFilter (<i>self</i>, <a href="qdir-filters.html">QDir.Filters</a> <i>filters</i>)</h3><h3 class="fn"><a name="setFilters" />QFileDialog.setFilters (<i>self</i>, QStringList <i>filters</i>)</h3><h3 class="fn"><a name="setHistory" />QFileDialog.setHistory (<i>self</i>, QStringList <i>paths</i>)</h3><p>Sets the browsing history of the filedialog to contain the given <i>paths</i>.</p> <p><b>See also</b> <a href="qfiledialog.html#history">history</a>().</p> <h3 class="fn"><a name="setIconProvider" />QFileDialog.setIconProvider (<i>self</i>, <a href="qfileiconprovider.html">QFileIconProvider</a> <i>provider</i>)</h3><p>Sets the icon provider used by the filedialog to the specified <i>provider</i>.</p> <p><b>See also</b> <a href="qfiledialog.html#iconProvider">iconProvider</a>().</p> <h3 class="fn"><a name="setItemDelegate" />QFileDialog.setItemDelegate (<i>self</i>, <a href="qabstractitemdelegate.html">QAbstractItemDelegate</a> <i>delegate</i>)</h3><p>Sets the item delegate used to render items in the views in the file dialog to the given <i>delegate</i>.</p> <p><b>Warning:</b> You should not share the same instance of a delegate between views. Doing so can cause incorrect or unintuitive editing behavior since each view connected to a given delegate may receive the <a href="qabstractitemdelegate.html#closeEditor">closeEditor()</a> signal, and attempt to access, modify or close an editor that has already been closed.</p> <p>Note that the model used is <a href="qfilesystemmodel.html">QFileSystemModel</a>. It has custom item data roles, which is described by the <a href="qfilesystemmodel.html#Roles-enum">Roles</a> enum. You can use a <a href="qfileiconprovider.html">QFileIconProvider</a> if you only want custom icons.</p> <p><b>See also</b> <a href="qfiledialog.html#itemDelegate">itemDelegate</a>(), <a href="qfiledialog.html#setIconProvider">setIconProvider</a>(), and <a href="qfilesystemmodel.html">QFileSystemModel</a>.</p> <h3 class="fn"><a name="setLabelText" />QFileDialog.setLabelText (<i>self</i>, <a href="qfiledialog.html#DialogLabel-enum">DialogLabel</a> <i>label</i>, QString <i>text</i>)</h3><p>Sets the <i>text</i> shown in the filedialog in the specified <i>label</i>.</p> <p><b>See also</b> <a href="qfiledialog.html#labelText">labelText</a>().</p> <h3 class="fn"><a name="setNameFilter" />QFileDialog.setNameFilter (<i>self</i>, QString <i>filter</i>)</h3><p>Sets the filter used in the file dialog to the given <i>filter</i>.</p> <p>If <i>filter</i> contains a pair of parentheses containing one or more of <b>anything*something</b>, separated by spaces, then only the text contained in the parentheses is used as the filter. This means that these calls are all equivalent:</p> <pre class="cpp"> dialog<span class="operator">.</span>setNameFilter(<span class="string">"All C++ files (*.cpp *.cc *.C *.cxx *.c++)"</span>); dialog<span class="operator">.</span>setNameFilter(<span class="string">"*.cpp *.cc *.C *.cxx *.c++"</span>); </pre> <p>This function was introduced in Qt 4.4.</p> <p><b>See also</b> <a href="qfiledialog.html#setNameFilters">setNameFilters</a>().</p> <h3 class="fn"><a name="setNameFilterDetailsVisible" />QFileDialog.setNameFilterDetailsVisible (<i>self</i>, bool <i>enabled</i>)</h3><h3 class="fn"><a name="setNameFilters" />QFileDialog.setNameFilters (<i>self</i>, QStringList <i>filters</i>)</h3><p>Sets the <i>filters</i> used in the file dialog.</p> <pre class="cpp"> <span class="type"><a href="qstringlist.html">QStringList</a></span> filters; filters <span class="operator"><</span><span class="operator"><</span> <span class="string">"Image files (*.png *.xpm *.jpg)"</span> <span class="operator"><</span><span class="operator"><</span> <span class="string">"Text files (*.txt)"</span> <span class="operator"><</span><span class="operator"><</span> <span class="string">"Any files (*)"</span>; <span class="type"><a href="qfiledialog.html">QFileDialog</a></span> dialog(<span class="keyword">this</span>); dialog<span class="operator">.</span>setNameFilters(filters); dialog<span class="operator">.</span><a href="qdialog.html#exec">exec_</a>(); </pre> <p>This function was introduced in Qt 4.4.</p> <p><b>See also</b> <a href="qfiledialog.html#nameFilters">nameFilters</a>().</p> <h3 class="fn"><a name="setOption" />QFileDialog.setOption (<i>self</i>, <a href="qfiledialog.html#Option-enum">Option</a> <i>option</i>, bool <i>on</i> = True)</h3><p>Sets the given <i>option</i> to be enabled if <i>on</i> is true; otherwise, clears the given <i>option</i>.</p> <p>This function was introduced in Qt 4.5.</p> <p><b>See also</b> <a href="qfiledialog.html#options-prop">options</a> and <a href="qfiledialog.html#testOption">testOption</a>().</p> <h3 class="fn"><a name="setOptions" />QFileDialog.setOptions (<i>self</i>, <a href="qfiledialog-options.html">Options</a> <i>options</i>)</h3><h3 class="fn"><a name="setProxyModel" />QFileDialog.setProxyModel (<i>self</i>, <a href="qabstractproxymodel.html">QAbstractProxyModel</a> <i>model</i>)</h3><p>The <i>model</i> argument has it's ownership transferred to Qt.</p><p>Sets the model for the views to the given <i>proxyModel</i>. This is useful if you want to modify the underlying model; for example, to add columns, filter data or add drives.</p> <p>Any existing proxy model will be removed, but not deleted. The file dialog will take ownership of the <i>proxyModel</i>.</p> <p>This function was introduced in Qt 4.3.</p> <p><b>See also</b> <a href="qfiledialog.html#proxyModel">proxyModel</a>().</p> <h3 class="fn"><a name="setReadOnly" />QFileDialog.setReadOnly (<i>self</i>, bool <i>enabled</i>)</h3><h3 class="fn"><a name="setResolveSymlinks" />QFileDialog.setResolveSymlinks (<i>self</i>, bool <i>enabled</i>)</h3><h3 class="fn"><a name="setSidebarUrls" />QFileDialog.setSidebarUrls (<i>self</i>, list-of-QUrl <i>urls</i>)</h3><p>Sets the <i>urls</i> that are located in the sidebar.</p> <p>For instance:</p> <pre class="cpp"> <span class="type"><a href="qlist.html">QList</a></span><span class="operator"><</span><span class="type"><a href="qurl.html">QUrl</a></span><span class="operator">></span> urls; urls <span class="operator"><</span><span class="operator"><</span> <span class="type"><a href="qurl.html">QUrl</a></span><span class="operator">.</span>fromLocalFile(<span class="string">"/home/gvatteka/dev/qt-45"</span>) <span class="operator"><</span><span class="operator"><</span> <span class="type"><a href="qurl.html">QUrl</a></span><span class="operator">.</span>fromLocalFile(<span class="type"><a href="qdesktopservices.html">QDesktopServices</a></span><span class="operator">.</span>storageLocation(<span class="type"><a href="qdesktopservices.html">QDesktopServices</a></span><span class="operator">.</span>MusicLocation)); <span class="type"><a href="qfiledialog.html">QFileDialog</a></span> dialog; dialog<span class="operator">.</span>setSidebarUrls(urls); dialog<span class="operator">.</span>setFileMode(<span class="type"><a href="qfiledialog.html">QFileDialog</a></span><span class="operator">.</span>AnyFile); <span class="keyword">if</span>(dialog<span class="operator">.</span>exec()) { <span class="comment">// ...</span> } </pre> <p>The file dialog will then look like this:</p> <p class="centerAlign"><img alt="" src="images/filedialogurls.png" /></p> <p>This function was introduced in Qt 4.3.</p> <p><b>See also</b> <a href="qfiledialog.html#sidebarUrls">sidebarUrls</a>().</p> <h3 class="fn"><a name="setViewMode" />QFileDialog.setViewMode (<i>self</i>, <a href="qfiledialog.html#ViewMode-enum">ViewMode</a> <i>mode</i>)</h3><h3 class="fn"><a name="setVisible" />QFileDialog.setVisible (<i>self</i>, bool <i>visible</i>)</h3><p>Reimplemented from <a href="qwidget.html#visible-prop">QWidget.setVisible</a>().</p> <h3 class="fn"><a name="sidebarUrls" />list-of-QUrl QFileDialog.sidebarUrls (<i>self</i>)</h3><p>Returns a list of urls that are currently in the sidebar</p> <p>This function was introduced in Qt 4.3.</p> <p><b>See also</b> <a href="qfiledialog.html#setSidebarUrls">setSidebarUrls</a>().</p> <h3 class="fn"><a name="testOption" />bool QFileDialog.testOption (<i>self</i>, <a href="qfiledialog.html#Option-enum">Option</a> <i>option</i>)</h3><p>Returns true if the given <i>option</i> is enabled; otherwise, returns false.</p> <p>This function was introduced in Qt 4.5.</p> <p><b>See also</b> <a href="qfiledialog.html#options-prop">options</a> and <a href="qfiledialog.html#setOption">setOption</a>().</p> <h3 class="fn"><a name="viewMode" /><a href="qfiledialog.html#ViewMode-enum">ViewMode</a> QFileDialog.viewMode (<i>self</i>)</h3><hr /><h2>Qt Signal Documentation</h2><h3 class="fn"><a name="currentChanged" />void currentChanged (const QString&)</h3><p>This is the default overload of this signal.</p><p>When the current file changes, this signal is emitted with the new file name as the <i>path</i> parameter.</p> <p><b>See also</b> <a href="qfiledialog.html#filesSelected">filesSelected</a>().</p> <h3 class="fn"><a name="directoryEntered" />void directoryEntered (const QString&)</h3><p>This is the default overload of this signal.</p><p>This signal is emitted when the user enters a <i>directory</i>.</p> <p>This function was introduced in Qt 4.3.</p> <h3 class="fn"><a name="fileSelected" />void fileSelected (const QString&)</h3><p>This is the default overload of this signal.</p><p>When the selection changes and the dialog is accepted, this signal is emitted with the (possibly empty) selected <i>file</i>.</p> <p><b>See also</b> <a href="qfiledialog.html#currentChanged">currentChanged</a>() and <a href="qdialog.html#DialogCode-enum">QDialog.Accepted</a>.</p> <h3 class="fn"><a name="filesSelected" />void filesSelected (const QStringList&)</h3><p>This is the default overload of this signal.</p><p>When the selection changes and the dialog is accepted, this signal is emitted with the (possibly empty) list of <i>selected</i> files.</p> <p><b>See also</b> <a href="qfiledialog.html#currentChanged">currentChanged</a>() and <a href="qdialog.html#DialogCode-enum">QDialog.Accepted</a>.</p> <h3 class="fn"><a name="filterSelected" />void filterSelected (const QString&)</h3><p>This is the default overload of this signal.</p><p>This signal is emitted when the user selects a <i>filter</i>.</p> <p>This function was introduced in Qt 4.3.</p> <address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td align="left" width="25%">PyQt 4.10.3 for X11</td><td align="center" width="50%">Copyright © <a href="http://www.riverbankcomputing.com">Riverbank Computing Ltd</a> and <a href="http://www.qtsoftware.com">Nokia</a> 2012</td><td align="right" width="25%">Qt 4.8.5</td></tr></table></div></address></body></html>