Member Function Documentation

[static] KEncodingFileDialog::Result KEncodingFileDialog::getOpenFileNameAndEncoding(const QString &encoding = QString(), const QUrl &startDir = QUrl(), const QString &filter = QString(), QWidget *parent = nullptr, const QString &title = QString())

Creates a modal file dialog and return the selected filename or an empty string if none was chosen additionally a chosen encoding value is returned.

Note that with this method the user must select an existing filename.

encoding The encoding shown in the encoding combo.

startDir This can either be

• The URL of the directory to start in.
• QString() to start in the current working directory, or the last directory where a file has been selected.
• ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
• '::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.

filter A shell glob or a MIME type filter that specifies which files to display. see KFileFilter::KFileFilter(const QString &label, const QStringList &filePatterns, const QStringList &mimePatterns) for examples of patterns.

parent The widget the dialog will be centered on initially.

title The name of the dialog widget.

[static] KEncodingFileDialog::Result KEncodingFileDialog::getOpenFileNamesAndEncoding(const QString &encoding = QString(), const QUrl &startDir = QUrl(), const QString &filter = QString(), QWidget *parent = nullptr, const QString &title = QString())

Creates a modal file dialog and returns the selected encoding and the selected filenames or an empty list if none was chosen.

Note that with this method the user must select an existing filename.

encoding The encoding shown in the encoding combo.

startDir This can either be

• The URL of the directory to start in.
• QString() to start in the current working directory, or the last directory where a file has been selected.
• ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
• '::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.

filter A shell glob or a MIME type filter that specifies which files to display. see KFileFilter::KFileFilter(const QString &label, const QStringList &filePatterns, const QStringList &mimePatterns) for examples of patterns.

parent The widget the dialog will be centered on initially.

title The name of the dialog widget.

[static] KEncodingFileDialog::Result KEncodingFileDialog::getOpenUrlAndEncoding(const QString &encoding = QString(), const QUrl &startDir = QUrl(), const QString &filter = QString(), QWidget *parent = nullptr, const QString &title = QString())

Creates a modal file dialog and returns the selected encoding and URL or an empty string if none was chosen.

Note that with this method the user must select an existing URL.

encoding The encoding shown in the encoding combo.

startDir This can either be

• The URL of the directory to start in.
• QString() to start in the current working directory, or the last directory where a file has been selected.
• ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
• '::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.

filter A shell glob or a MIME type filter that specifies which files to display. see KFileFilter::KFileFilter(const QString &label, const QStringList &filePatterns, const QStringList &mimePatterns) for examples of patterns.

parent The widget the dialog will be centered on initially.

title The name of the dialog widget.

[static] KEncodingFileDialog::Result KEncodingFileDialog::getOpenUrlsAndEncoding(const QString &encoding = QString(), const QUrl &startDir = QUrl(), const QString &filter = QString(), QWidget *parent = nullptr, const QString &title = QString())

Creates a modal file dialog and returns the selected encoding URLs or an empty list if none was chosen.

Note that with this method the user must select an existing filename.

encoding The encoding shown in the encoding combo.

startDir This can either be

The URL of the directory to start in.

QString() to start in the current working directory, or the last directory where a file has been selected.

':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.

'::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.

filter A shell glob or a MIME type filter that specifies which files to display. see KFileFilter::KFileFilter(const QString &label, const QStringList &filePatterns, const QStringList &mimePatterns) for examples of patterns.

parent The widget the dialog will be centered on initially.

title The name of the dialog widget.

[static] KEncodingFileDialog::Result KEncodingFileDialog::getSaveFileNameAndEncoding(const QString &encoding = QString(), const QUrl &startDir = QUrl(), const QString &filter = QString(), QWidget *parent = nullptr, const QString &title = QString())

Creates a modal file dialog and returns the selected encoding and filename or an empty string if none was chosen.

Note that with this method the user need not select an existing filename.

encoding The encoding shown in the encoding combo. startDir This can either be

• The URL of the directory to start in.
• a relative path or a filename determining the directory to start in and the file to be selected.
• QString() to start in the current working directory, or the last directory where a file has been selected.
• ':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.
• '::<keyword>;' to start in the directory last used by a filedialog in any application that specified the same keyword.

filter A shell glob or a MIME type filter that specifies which files to display. see KFileFilter::KFileFilter(const QString &label, const QStringList &filePatterns, const QStringList &mimePatterns) for examples of patterns.

parent The widget the dialog will be centered on initially.

title The name of the dialog widget.

[static] KEncodingFileDialog::Result KEncodingFileDialog::getSaveUrlAndEncoding(const QString &encoding = QString(), const QUrl &startDir = QUrl(), const QString &filter = QString(), QWidget *parent = nullptr, const QString &title = QString())

Creates a modal file dialog and returns the selected encoding and filename or an empty string if none was chosen.

Note that with this method the user need not select an existing filename.

encoding The encoding shown in the encoding combo.

startDir This can either be

The URL of the directory to start in.

a relative path or a filename determining the directory to start in and the file to be selected.

QString() to start in the current working directory, or the last directory where a file has been selected.

':<keyword>' to start in the directory last used by a filedialog in the same application that specified the same keyword.

'::<keyword>' to start in the directory last used by a filedialog in any application that specified the same keyword.

filter A shell glob or a MIME type filter that specifies which files to display. see KFileFilter::KFileFilter(const QString &label, const QStringList &filePatterns, const QStringList &mimePatterns) for examples of patterns.

parent The widget the dialog will be centered on initially.

title The name of the dialog widget.