QString QFileDialog::getOpenFileName ( QWidget * parent = 0, const QString & caption = QString(), const QString & dir = QString(), const QString & filter = QString(), QString * selectedFilter = 0, Options options = 0 ) [static]
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.
QString s = QFileDialog::getOpenFileName( this, "Choose a file to open", "/home", "Images (*.png *.xpm *.jpg)");The function creates a modal file dialog with the given
parent widget. If the parent is not 0, the dialog will be shown centered over the parent widget.
The file dialog's working directory will be set to
dir. If
dir includes a file name, the file will be selected. Only files that match the given
filter are shown. The filter selected is set to
selectedFilter. The parameters
dir,
selectedFilter, and
filter may be empty strings. The
options argument holds various options about how to run the dialog, see the
QFileDialog::Option enum for more information on the flags you can pass.
The dialog's caption is set to
caption. If
caption is not specified then a default caption will be used.
Under Windows and Mac OS X, this static function will use the native file dialog and not a
QFileDialog.
Note that on Windows the dialog will spin a blocking modal event loop that will not dispatch any QTimers, and if parent is not 0 then it will position the dialog just under the parent's title bar.
Under Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if /usr/tmp is a symlink to /var/tmp, the file dialog will change to /var/tmp after entering /usr/tmp. If
options includes
DontResolveSymlinks, the file dialog will treat symlinks as regular directories.
QStringList QFileDialog::getOpenFileNames ( QWidget * parent = 0, const QString & caption = QString(), const QString & dir = QString(), const QString & filter = QString(), QString * selectedFilter = 0, Options options = 0 ) [static]
This is a convenience static function that will return one or more existing files selected by the user.
QStringList files = QFileDialog::getOpenFileNames( this, "Select one or more files to open", "/home", "Images (*.png *.xpm *.jpg)");This function creates a modal file dialog with the given
parent widget. If the parent is not 0, the dialog will be shown centered over the parent widget.
The file dialog's working directory will be set to
dir. If
dir includes a file name, the file will be selected. The filter is set to
filter so that only those files which match the filter are shown. The filter selected is set to
selectedFilter. The parameters
dir,
selectedFilter and
filter may be empty strings.
The dialog's caption is set to
caption. If
caption is not specified then a default caption will be used.
Under Windows and Mac OS X, this static function will use the native file dialog and not a
QFileDialog.
Note that on Windows the dialog will spin a blocking modal event loop that will not dispatch any QTimers, and if parent is not 0 then it will position the dialog just under the parent's title bar.
Under Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if /usr/tmp is a symlink to /var/tmp, the file dialog will change to /var/tmp after entering /usr/tmp. The
options argument holds various options about how to run the dialog, see the
QFileDialog::Option enum for more information on the flags you can pass.
Bookmarks