Method getSaveFileName

src/Gui/FileDialog.cpp:516–644

* This is a convenience static function that will return a file name selected by the user. The file * does not have to exist. */

 * does not have to exist.
 */
QString FileDialog::getSaveFileName(
    QWidget* parent,
    const QString& caption,
    const QString& startPath,
    const FilterList& filters,
    qsizetype* selectedFilterIndex,
    Options options
)
{
    ActionDisabler actionDisabler {};
    qsizetype actuallySelectedFilterIndex = selectedFilterIndex != nullptr ? *selectedFilterIndex
                                                                           : -1;
    QString suggestedPath = startPath;
    bool hasFilename = false;
    if (suggestedPath.isEmpty()) {
        suggestedPath = getPreferredDialogDirectory();
    }
    else {
        QFileInfo fi(suggestedPath);
        if (fi.isRelative()) {
            suggestedPath = getPreferredDialogDirectory();
            suggestedPath += QStringLiteral("/");
            suggestedPath += fi.fileName();
            fi.setFile(suggestedPath);
        }
        // If the startPath points to a directory (path ends with separator, or points
        // to existing dir), don't touch it and don't use QFileDialog::selectFile() later.
        if (!(fi.fileName().isEmpty() || fi.isDir())) {
            // If there is a file name at the end, make sure it matches one of the patterns
            // of the preselected filter, if applicable.
            hasFilename = true;
            if (actuallySelectedFilterIndex >= 0) {
                FileDialogInternal::normalizeSavePath(
                    suggestedPath,
                    filters[actuallySelectedFilterIndex]
                );
            }
        }
    }

    QString windowTitle = caption;
    if (windowTitle.isEmpty()) {
        windowTitle = FileDialog::tr("Save As");
    }

    options |= QFileDialog::HideNameFilterDetails;

    QString file;
    if (DialogOptions::dontUseNativeFileDialog()) {
        const bool showPatterns = FileDialogInternal::getPreferShowFilterPatterns();
        const auto qtFilterList = toQtFilterList(filters, showPatterns);
        QList<QUrl> urls = fetchSidebarUrls();

        options |= QFileDialog::DontUseNativeDialog;

        FileDialog dlg(parent);
        dlg.setOptions(options);
        dlg.setWindowTitle(windowTitle);