KoFileDialog Class Reference

#include <KoFileDialog.h>

Inheritance diagram for KoFileDialog:

Public Types
enum	DialogType {   OpenFile , OpenFiles , OpenDirectory , ImportFile ,   ImportFiles , ImportDirectory , SaveFile }

Public Slots
void	onFilterSelected (const QString &filter)

Public Member Functions
QString	filename ()
	Get the file name the user selected in the file dialog.
QStringList	filenames ()
	Get the file names the user selected in the file dialog.
	KoFileDialog (QWidget *parent, KoFileDialog::DialogType type, const QString &dialogName)
	constructor
	Private (QWidget *parent_, KoFileDialog::DialogType dialogType_, const QString caption_, const QString defaultDir_, const QString dialogName_)
QString	selectedMimeType () const
QString	selectedNameFilter () const
	selectedNameFilter returns the name filter the user selected, either directory or by clicking on it.
void	selectNameFilter (const QString &filter)
void	setCaption (const QString &caption)
void	setDefaultDir (const QString &defaultDir, bool force=false)
	setDefaultDir set the default directory to defaultDir.
void	setDirectoryUrl (const QUrl &defaultUri)
	setDirectoryUrl set the default URI to defaultUri.
void	setImageFilters ()
	setImageFilters sets the name filters for the file dialog to all image formats Qt's QImageReader supports.
void	setMimeTypeFilters (const QStringList &mimeTypeList, QString defaultMimeType=QString())
	setMimeTypeFilters Update the list of file filters from mime types.
void	setNameFilter (const QString &filter)
	~KoFileDialog () override
	~Private ()

Public Attributes
QString	caption
QString	defaultDirectory
QString	defaultFilter
QUrl	defaultUri
QString	dialogName
QScopedPointer< KisPreviewFileDialog >	fileDialog
QStringList	filterList
QString	mimeType
QWidget *	parent
QString	proposedFileName
QMap< QString, QString >	suffixes
KoFileDialog::DialogType	type

Private Member Functions
void	createFileDialog ()
const QPair< QStringList, QMap< QString, QString > >	getFilterStringListFromMime (const QStringList &mimeList, bool withAllSupportedEntry=false)
QString	getUsedDir (const QString &dialogName)
void	saveUsedDir (const QString &fileName, const QString &dialogName)
Private Member Functions inherited from Private
	Private (KisCanvas2 *c)

Static Private Member Functions
static QStringList	splitNameFilter (const QString &nameFilter, QStringList *mimeList)
	splitNameFilter take a single line of a QDialog name filter and split it into several lines. This is needed because a single line name filter can contain more than one mimetype, making it impossible to figure out the correct extension.

Private Attributes
Private *const	d
Private Attributes inherited from Private
KisCanvas2 *	canvas
int	displayedFrame
int	intendedFrame

Detailed Description

Wrapper around QFileDialog providing native file dialogs on KDE/Gnome/Windows/OSX/etc.

Definition at line 32 of file KoFileDialog.cpp.

Member Enumeration Documentation

DialogType

enum KoFileDialog::DialogType

Enumerator
OpenFile
OpenFiles
OpenDirectory
ImportFile
ImportFiles
ImportDirectory
SaveFile

Definition at line 26 of file KoFileDialog.h.

                    {
        OpenFile,
        OpenFiles,
        OpenDirectory,
        ImportFile,
        ImportFiles,
        ImportDirectory,
        SaveFile
    };

Constructor & Destructor Documentation

~Private()

KoFileDialog::~Private ( )

inline

Definition at line 50 of file KoFileDialog.cpp.

    {
    }

KoFileDialog()

KoFileDialog::KoFileDialog	(	QWidget *	parent,
		KoFileDialog::DialogType	type,
		const QString &	dialogName )

constructor

Parameters

parent	The parent of the file dialog
dialogType	usage of the file dialog
dialogName	the name for the file dialog. This will be used to open the filedialog in the last open location, instead the specified directory.

Returns

The name of the entry user selected in the file dialog

Definition at line 68 of file KoFileDialog.cpp.

    : d(new Private(parent, type, "", getUsedDir(dialogName), dialogName))
{
}

~KoFileDialog()

KoFileDialog::~KoFileDialog ( )

override

Definition at line 75 of file KoFileDialog.cpp.

{
    delete d;
}

References d.

Member Function Documentation

createFileDialog()

void KoFileDialog::createFileDialog ( )

private

Definition at line 138 of file KoFileDialog.cpp.

{
    d->fileDialog.reset(new KisPreviewFileDialog(d->parent, d->caption, d->defaultDirectory + "/" + d->proposedFileName));
    if (!d->defaultUri.isEmpty()) {
        d->fileDialog->setDirectoryUrl(d->defaultUri);
    }
    connect(d->fileDialog.get(), SIGNAL(filterSelected(const QString&)), this, SLOT(onFilterSelected(const QString&)));
 
#ifdef Q_OS_MACOS
    KisMacosSecurityBookmarkManager *bookmarkmngr = KisMacosSecurityBookmarkManager::instance();
    if(bookmarkmngr->isSandboxed()) {
        connect(d->fileDialog.get(), SIGNAL(urlSelected  (const QUrl&)), bookmarkmngr, SLOT(addBookmarkAndCheckParentDir(const QUrl&)));
    }
#endif
 
    KConfigGroup group = KSharedConfig::openConfig()->group("File Dialogs");
 
    bool dontUseNative = true;
#ifdef Q_OS_ANDROID
    dontUseNative = false;
#endif
#ifdef Q_OS_UNIX
    if (qgetenv("XDG_CURRENT_DESKTOP") == "KDE") {
        dontUseNative = false;
    }
#endif
#ifdef Q_OS_MACOS
    dontUseNative = false;
#endif
#ifdef Q_OS_WIN
    dontUseNative = false;
#endif
 
    bool optionDontUseNative;
    if (!qEnvironmentVariable("APPIMAGE").isEmpty()) {
        // AppImages don't have access to platform plugins. BUG: 447805
        optionDontUseNative = false;
    } else {
        optionDontUseNative = group.readEntry("DontUseNativeFileDialog", dontUseNative);
    }
 
    d->fileDialog->setOption(QFileDialog::DontUseNativeDialog, optionDontUseNative);
    d->fileDialog->setOption(QFileDialog::DontConfirmOverwrite, false);
    d->fileDialog->setOption(QFileDialog::HideNameFilterDetails, dontUseNative ? true : false);
 
 
#ifdef Q_OS_MACOS
    QList<QUrl> urls = d->fileDialog->sidebarUrls();
    QUrl volumes = QUrl::fromLocalFile("/Volumes");
    if (!urls.contains(volumes)) {
        urls.append(volumes);
    }
 
    d->fileDialog->setSidebarUrls(urls);
#endif
 
    if (d->type == SaveFile) {
        d->fileDialog->setAcceptMode(QFileDialog::AcceptSave);
        d->fileDialog->setFileMode(QFileDialog::AnyFile);
    }
    else { // open / import
 
        d->fileDialog->setAcceptMode(QFileDialog::AcceptOpen);
 
        if (d->type == ImportDirectory || d->type == OpenDirectory) {
            d->fileDialog->setFileMode(QFileDialog::Directory);
            d->fileDialog->setOption(QFileDialog::ShowDirsOnly, true);
        }
        else { // open / import file(s)
            if (d->type == OpenFile || d->type == ImportFile)
            {
                d->fileDialog->setFileMode(QFileDialog::ExistingFile);
            }
            else { // files
                d->fileDialog->setFileMode(QFileDialog::ExistingFiles);
            }
        }
    }
 
#ifndef Q_OS_ANDROID
    d->fileDialog->setNameFilters(d->filterList);
 
    if (!d->proposedFileName.isEmpty()) {
        QString mime = KisMimeDatabase::mimeTypeForFile(d->proposedFileName, d->type == KoFileDialog::SaveFile ? false : true);
 
        QString description = KisMimeDatabase::descriptionForMimeType(mime);
        Q_FOREACH(const QString &filter, d->filterList) {
            if (filter.startsWith(description)) {
                d->fileDialog->selectNameFilter(filter);
                break;
            }
        }
    }
    else if (!d->defaultFilter.isEmpty()) {
        d->fileDialog->selectNameFilter(d->defaultFilter);
    }
#endif
 
    if (d->type == ImportDirectory ||
            d->type == ImportFile || d->type == ImportFiles ||
            d->type == SaveFile) {
 
        bool allowModal = true;
// MacOS do not declare native file dialog as modal BUG:413241.
#ifdef Q_OS_MACOS
        allowModal = optionDontUseNative;
//        if ( d->proposedFileName.isEmpty() ) {
//            d->fileDialog->selectFile("untitled.kra");
//        } else {
//            d->fileDialog->selectFile(d->proposedFileName);
//        }
//        qDebug() << d->proposedFileName.isEmpty() << d->proposedFileName << d->defaultDirectory;
#endif
        if (allowModal) {
            d->fileDialog->setWindowModality(Qt::WindowModal);
        }
    }
    d->fileDialog->resetIconProvider();
 
    // QFileDialog::filterSelected is not emitted with the initial value
    onFilterSelected(d->fileDialog->selectedNameFilter());
}

References connect(), d, KisMimeDatabase::descriptionForMimeType(), ImportDirectory, ImportFile, ImportFiles, KisMacosSecurityBookmarkManager::instance(), KisMacosSecurityBookmarkManager::isSandboxed(), KisMimeDatabase::mimeTypeForFile(), onFilterSelected(), OpenDirectory, OpenFile, and SaveFile.

filename()

QString KoFileDialog::filename

(

)

Get the file name the user selected in the file dialog.

Definition at line 261 of file KoFileDialog.cpp.

{
    QString url;
    createFileDialog();
 
#ifdef Q_OS_ANDROID
    if (d->type == SaveFile) {
        QString extension = ".kra";
        QInputDialog mimeSelector;
        mimeSelector.setLabelText(i18n("Save As:"));
        mimeSelector.setComboBoxItems(d->filterList);
        mimeSelector.setOkButtonText(KStandardGuiItem::ok().text());
        mimeSelector.setCancelButtonText(KStandardGuiItem::cancel().text());
        // combobox as they stand, are very hard to scroll on a touch device
        mimeSelector.setOption(QInputDialog::UseListViewForComboBoxItems);
 
        if (mimeSelector.exec() == QDialog::Accepted) {
            const QString selectedFilter = mimeSelector.textValue();
            int start = selectedFilter.indexOf("*.") + 1;
            int end = selectedFilter.indexOf(" ", start);
            int n = end - start;
            extension = selectedFilter.mid(start, n);
            if (!extension.startsWith(".")) {
                extension = "." + extension;
            }
            d->fileDialog->selectNameFilter(selectedFilter);
 
            const QString proposedFileBaseName = QFileInfo(d->proposedFileName).baseName();
            // HACK: discovered by looking into the code
            d->fileDialog->setWindowTitle(proposedFileBaseName.isEmpty() ? QString("Untitled" + extension)
                                                                         : proposedFileBaseName + extension);
        } else {
            return url;
        }
    }
#endif
 
    bool retryNeeded;
    do {
        retryNeeded = false;
        if (d->fileDialog->exec() == QDialog::Accepted) {
            url = d->fileDialog->selectedFiles().first();
        } else {
            url = QString();
            break;
        }
 
        // The Android native file selector does not know to add the .kra
        // extension (MIME type not registered), so just skip the whole file
        // suffix check for Android.
#ifndef Q_OS_ANDROID
        const QString suffix = QFileInfo(url).suffix();
        bool isValidSuffix = true;
        if (KisMimeDatabase::mimeTypeForSuffix(suffix).isEmpty()) {
            warnWidgetUtils << "Selected file name suffix" << suffix << "does not match known MIME types";
            isValidSuffix = false;
        }
 
        if (d->type == SaveFile && (suffix.isEmpty() || !isValidSuffix)) {
            QString extension;
            if (d->suffixes.contains(d->fileDialog->selectedNameFilter())) {
                extension = d->suffixes[d->fileDialog->selectedNameFilter()];
                if (!extension.isEmpty()) {
                    // Append the default file extension to the file name before
                    // relaunching the file selector. We do _not_ just append
                    // the extension and return the new file name because:
                    //  * it bypasses the file overwrite prompt provided by the
                    //    file selector.
                    //  * doing so will break sandboxed macOS and Android,
                    //    because access to user files is restricted and must
                    //    be done through the native file selector.
                    url.append('.').append(extension);
                    d->fileDialog->selectFile(url);
                }
            }
            if (extension.isEmpty()) {
                // Use the first extension of the selected filter just as a suggestion
                QString selectedFilter;
                // skip index 0 which is "All supported formats"
                for (int i = 1; i < d->filterList.size(); ++i) {
                    if (d->filterList[i].startsWith(d->fileDialog->selectedNameFilter())) {
                        selectedFilter = d->filterList[i];
                        break;
                    }
                }
                int start = selectedFilter.indexOf("*.") + 2;
                int end = selectedFilter.indexOf(" ", start);
                if (start != -1 + 2 && end != -1) {
                    extension = selectedFilter.mid(start, end - start);
                }
            }
            QMessageBox::warning(d->parent, d->caption,
                i18n("The selected file name does not have a file extension that Krita understands.\n"
                     "Make sure the file name ends in '.%1' for example.", extension));
            retryNeeded = true;
 
// We can only write to the Uri that was returned, we don't have permission to change the Uri.
#if !(defined(Q_OS_MACOS) || defined(Q_OS_ANDROID))
            url = url + extension;
#endif
        }
#endif
    } while (retryNeeded);
 
    if (!url.isEmpty()) {
        d->mimeType = KisMimeDatabase::mimeTypeForFile(url, d->type == KoFileDialog::SaveFile ? false : true);
        saveUsedDir(url, d->dialogName);
    }
    return url;
}

References createFileDialog(), d, KisMimeDatabase::mimeTypeForFile(), KisMimeDatabase::mimeTypeForSuffix(), SaveFile, saveUsedDir(), and warnWidgetUtils.

filenames()

QStringList KoFileDialog::filenames

(

)

Get the file names the user selected in the file dialog.

Definition at line 372 of file KoFileDialog.cpp.

{
    QStringList urls;
 
    createFileDialog();
    if (d->fileDialog->exec() == QDialog::Accepted) {
        urls = d->fileDialog->selectedFiles();
    }
    if (urls.size() > 0) {
        saveUsedDir(urls.first(), d->dialogName);
    }
    return urls;
}

References createFileDialog(), d, and saveUsedDir().

getFilterStringListFromMime()

const QPair< QStringList, QMap< QString, QString > > KoFileDialog::getFilterStringListFromMime ( const QStringList & mimeList, bool withAllSupportedEntry = false )

private

getUsedDir()

QString KoFileDialog::getUsedDir ( const QString & dialogName )

private

Definition at line 567 of file KoFileDialog.cpp.

{
    if (dialogName.isEmpty()) return "";
 
    KConfigGroup group =  KSharedConfig::openConfig()->group("File Dialogs");
    QString dir = group.readEntry(dialogName, "");
    return dir;
}

References dialogName.

onFilterSelected

void KoFileDialog::onFilterSelected ( const QString & filter )

slot

Definition at line 588 of file KoFileDialog.cpp.

{
    debugWidgetUtils << "KoFileDialog::onFilterSelected" << filter;
 
    // Setting default suffix for Android is broken as of Qt 5.12.0, returning the file
    // with extension added but no write permissions granted.
#ifndef Q_OS_ANDROID
    QFileDialog::FileMode mode = d->fileDialog->fileMode();
    if (mode != QFileDialog::Directory && !d->fileDialog->testOption(QFileDialog::ShowDirsOnly)) {
        // we do not need suffixes for directories
        if (d->suffixes.contains(filter)) {
            QString suffix = d->suffixes[filter];
            debugWidgetUtils << "  Setting default suffix to" << suffix;
            d->fileDialog->setDefaultSuffix(suffix);
        } else {
            warnWidgetUtils << "KoFileDialog::onFilterSelected: Cannot find suffix for filter" << filter;
            d->fileDialog->setDefaultSuffix("");
        }
    }
#endif
}

References d, debugWidgetUtils, and warnWidgetUtils.

Private()

KoFileDialog::Private ( QWidget * parent_, KoFileDialog::DialogType dialogType_, const QString caption_, const QString defaultDir_, const QString dialogName_ )

inline

Definition at line 35 of file KoFileDialog.cpp.

        : parent(parent_)
        , type(dialogType_)
        , dialogName(dialogName_)
        , caption(caption_)
        , defaultDirectory(defaultDir_)
        , filterList(QStringList())
        , defaultFilter(QString())
    {
    }

saveUsedDir()

void KoFileDialog::saveUsedDir ( const QString & fileName, const QString & dialogName )

private

Definition at line 576 of file KoFileDialog.cpp.

{
 
    if (dialogName.isEmpty()) return;
 
    QFileInfo fileInfo(fileName);
    KConfigGroup group =  KSharedConfig::openConfig()->group("File Dialogs");
    group.writeEntry(dialogName, fileInfo.absolutePath());
 
}

References dialogName.

selectedMimeType()

QString KoFileDialog::selectedMimeType

(

)

const

Definition at line 133 of file KoFileDialog.cpp.

{
    return d->mimeType;
}

References d.

selectedNameFilter()

QString KoFileDialog::selectedNameFilter

(

)

const

selectedNameFilter returns the name filter the user selected, either directory or by clicking on it.

Returns

Definition at line 128 of file KoFileDialog.cpp.

{
    return d->fileDialog->selectedNameFilter();
}

References d.

selectNameFilter()

void KoFileDialog::selectNameFilter

(

const QString &

filter

)

Definition at line 123 of file KoFileDialog.cpp.

{
    d->defaultFilter = filter;
}

References d.

setCaption()

void KoFileDialog::setCaption

(

const QString &

caption

)

Definition at line 80 of file KoFileDialog.cpp.

{
    d->caption = caption;
}

References caption, and d.

setDefaultDir()

void KoFileDialog::setDefaultDir	(	const QString &	defaultDir,
		bool	force = false )

setDefaultDir set the default directory to defaultDir.

Parameters

defaultDir

a path to a file or directory

Definition at line 85 of file KoFileDialog.cpp.

{
    if (!defaultDir.isEmpty()) {
        if (d->defaultDirectory.isEmpty() || force) {
            QFileInfo f(defaultDir);
            if (f.isDir()) {
                d->defaultDirectory = defaultDir;
            }
            else {
                d->defaultDirectory = f.absolutePath();
            }
        }
        if (!QFileInfo(defaultDir).isDir()) {
            d->proposedFileName = QFileInfo(defaultDir).fileName();
        }
    }
}

References d.

setDirectoryUrl()

void KoFileDialog::setDirectoryUrl

(

const QUrl &

defaultUri

)

setDirectoryUrl set the default URI to defaultUri.

Parameters

defaultUri

a Uri to a file from some ContentProvider

Used only on Android.

Definition at line 103 of file KoFileDialog.cpp.

{
    d->defaultUri = defaultUri;
}

References d, and defaultUri.

setImageFilters()

void KoFileDialog::setImageFilters

(

)

setImageFilters sets the name filters for the file dialog to all image formats Qt's QImageReader supports.

Definition at line 108 of file KoFileDialog.cpp.

{
    QStringList imageFilters;
    // add filters for all formats supported by QImage
    Q_FOREACH (const QByteArray &format, QImageReader::supportedImageFormats()) {
        imageFilters << QLatin1String("image/") + format;
    }
    setMimeTypeFilters(imageFilters);
}

References setMimeTypeFilters().

setMimeTypeFilters()

void KoFileDialog::setMimeTypeFilters	(	const QStringList &	mimeTypeList,
		QString	defaultMimeType = QString() )

setMimeTypeFilters Update the list of file filters from mime types.

Parameters

mimeTypeList	A list of mime types that forms the basis of this dialog's file filters
defaultMimeType	Sets the default filter based on this mime type

Definition at line 419 of file KoFileDialog.cpp.

{
    constexpr bool withAllSupportedEntry = true;
    QStringList mimeSeen;
 
    struct FilterData
    {
        QString descriptionOnly;
        QString fullLine;
        QString defaultSuffix;
    };
 
    FilterData defaultFilter {};
    // 1
    QString allSupported;
    // 2
    FilterData kritaNative {};
    // 3
    FilterData ora {};
    // remaining
    QVector<FilterData> otherFileTypes;
    // All files
    bool hasAllFilesFilter = false;
 
    QStringList mimeList = mimeTypeList;
    mimeList.sort();
 
    Q_FOREACH(const QString &mimeType, mimeList) {
        if (!mimeSeen.contains(mimeType)) {
            if (mimeType == QLatin1String("application/octet-stream")) {
                // QFileDialog uses application/octet-stream for the
                // "All files (*)" filter. We can do the same here.
                hasAllFilesFilter = true;
                mimeSeen << mimeType;
                continue;
            }
            QString description = KisMimeDatabase::descriptionForMimeType(mimeType);
            if (description.isEmpty() && !mimeType.isEmpty()) {
                description = mimeType.split("/")[1];
                if (description.startsWith("x-")) {
                    description = description.remove(0, 2);
                }
            }
 
 
            QString oneFilter;
            const QStringList suffixes = KisMimeDatabase::suffixesForMimeType(mimeType);
            KIS_SAFE_ASSERT_RECOVER(!suffixes.isEmpty()) {
                warnWidgetUtils << "KoFileDialog: Found no suffixes for mime type" << mimeType;
                continue;
            }
 
            Q_FOREACH(const QString &suffix, suffixes) {
                const QString glob = QStringLiteral("*.") + suffix;
                oneFilter.append(glob + " ");
                if (withAllSupportedEntry) {
                    allSupported.append(glob + " ");
                }
#ifdef Q_OS_LINUX
                if (qgetenv("XDG_CURRENT_DESKTOP") == "GNOME") {
                    oneFilter.append(glob.toUpper() + " ");
                    if (withAllSupportedEntry) {
                        allSupported.append(glob.toUpper() + " ");
                    }
                }
#endif
            }
 
            Q_ASSERT(!description.isEmpty());
 
            FilterData filterData {};
            filterData.descriptionOnly = description;
            filterData.fullLine = description + " ( " + oneFilter + ")";
            filterData.defaultSuffix = suffixes.first();
 
            if (mimeType == QLatin1String("application/x-krita")) {
                kritaNative = filterData;
            } else if (mimeType == QLatin1String("image/openraster")) {
                ora = filterData;
            } else {
                otherFileTypes.append(filterData);
            }
            if (defaultMimeType == mimeType) {
                debugWidgetUtils << "KoFileDialog: Matched default MIME type to filter" << filterData.fullLine;
                defaultFilter = filterData;
            }
            mimeSeen << mimeType;
        }
    }
 
    QStringList retFilterList;
    QMap<QString, QString> retFilterToSuffixMap;
    auto addFilterItem = [&](const FilterData &filterData) {
        if (retFilterList.contains(filterData.fullLine)) {
            debugWidgetUtils << "KoFileDialog: Duplicated filter" << filterData.fullLine;
            return;
        }
        retFilterList.append(filterData.fullLine);
        // the "simplified" version that comes to "onFilterSelect" when details are disabled
        retFilterToSuffixMap.insert(filterData.descriptionOnly, filterData.defaultSuffix);
        // "full version" that comes when details are enabled
        retFilterToSuffixMap.insert(filterData.fullLine, filterData.defaultSuffix);
    };
 
    if (!allSupported.isEmpty()) {
        FilterData allFilter {};
        if (allSupported.contains("*.kra")) {
            allSupported.remove("*.kra ");
            allSupported.prepend("*.kra ");
            allFilter.defaultSuffix = QStringLiteral("kra");
        } else if (!defaultFilter.fullLine.isEmpty()) {
            const QString suffixToMove = QString("*.") + defaultFilter.defaultSuffix + " ";
            allSupported.remove(suffixToMove);
            allSupported.prepend(suffixToMove);
            allFilter.defaultSuffix = defaultFilter.defaultSuffix;
        } else {
            // XXX: we don't have a meaningful default suffix
            warnWidgetUtils << "KoFileDialog: No default suffix for 'All supported formats'";
            allFilter.defaultSuffix = QStringLiteral("");
        }
        allFilter.descriptionOnly = i18n("All supported formats");
        allFilter.fullLine = allFilter.descriptionOnly + " ( " + allSupported + ")";
        addFilterItem(allFilter);
    }
    if (!kritaNative.fullLine.isEmpty()) {
        addFilterItem(kritaNative);
    }
    if (!ora.fullLine.isEmpty()) {
        addFilterItem(ora);
    }
 
    std::sort(otherFileTypes.begin(), otherFileTypes.end(), [](const FilterData &a, const FilterData &b) {
        return a.descriptionOnly < b.descriptionOnly;
    });
    Q_FOREACH(const FilterData &filterData, otherFileTypes) {
        addFilterItem(filterData);
    }
 
    if (hasAllFilesFilter) {
        // Reusing Qt's existing "All files" translation
        retFilterList.append(QFileDialog::tr("All files (*)"));
    }
 
    d->filterList = retFilterList;
    d->suffixes = retFilterToSuffixMap;
    d->defaultFilter = defaultFilter.fullLine; // this can be empty
}

References d, debugWidgetUtils, defaultFilter, KisMimeDatabase::descriptionForMimeType(), KIS_SAFE_ASSERT_RECOVER, mimeType, suffixes, KisMimeDatabase::suffixesForMimeType(), and warnWidgetUtils.

setNameFilter()

void KoFileDialog::setNameFilter

(

const QString &

filter

)

Definition at line 118 of file KoFileDialog.cpp.

{
    d->filterList = filter.split(";;");
}

References d.

splitNameFilter()

QStringList KoFileDialog::splitNameFilter ( const QString & nameFilter, QStringList * mimeList )

staticprivate

splitNameFilter take a single line of a QDialog name filter and split it into several lines. This is needed because a single line name filter can contain more than one mimetype, making it impossible to figure out the correct extension.

The methods takes care of some duplicated extensions, like jpeg and jpg.

Parameters

nameFilter	the namefilter to be split
mimeList	a pointer to the list with mimes that shouldn't be added.

Returns

a stringlist of all name filters.

Definition at line 386 of file KoFileDialog.cpp.

{
    Q_ASSERT(mimeList);
 
    QStringList filters;
    QString description;
 
    if (nameFilter.contains("(")) {
        description = nameFilter.left(nameFilter.indexOf("(") -1).trimmed();
    }
 
    QStringList entries = nameFilter.mid(nameFilter.indexOf("(") + 1).split(" ", Qt::SkipEmptyParts);
 
    entries.sort();
    Q_FOREACH (QString entry, entries) {
 
        entry = entry.remove("*");
        entry = entry.remove(")");
 
        QString mimeType = KisMimeDatabase::mimeTypeForSuffix(entry);
        if (mimeType != "application/octet-stream") {
            if (!mimeList->contains(mimeType)) {
                mimeList->append(mimeType);
                filters.append(KisMimeDatabase::descriptionForMimeType(mimeType) + " ( *" + entry + " )");
            }
        }
        else {
            filters.append(entry.remove(".").toUpper() + " " + description + " ( *." + entry + " )");
        }
    }
    return filters;
}

References KisMimeDatabase::descriptionForMimeType(), mimeType, and KisMimeDatabase::mimeTypeForSuffix().

Member Data Documentation

caption

QString KoFileDialog::caption

Definition at line 57 of file KoFileDialog.cpp.

d

Private* const KoFileDialog::d

private

Definition at line 131 of file KoFileDialog.h.

defaultDirectory

QString KoFileDialog::defaultDirectory

Definition at line 58 of file KoFileDialog.cpp.

defaultFilter

QString KoFileDialog::defaultFilter

Definition at line 63 of file KoFileDialog.cpp.

defaultUri

QUrl KoFileDialog::defaultUri

Definition at line 60 of file KoFileDialog.cpp.

dialogName

QString KoFileDialog::dialogName

Definition at line 56 of file KoFileDialog.cpp.

fileDialog

QScopedPointer<KisPreviewFileDialog> KoFileDialog::fileDialog

Definition at line 64 of file KoFileDialog.cpp.

filterList

QStringList KoFileDialog::filterList

Definition at line 61 of file KoFileDialog.cpp.

mimeType

QString KoFileDialog::mimeType

Definition at line 65 of file KoFileDialog.cpp.

parent

QWidget* KoFileDialog::parent

Definition at line 54 of file KoFileDialog.cpp.

proposedFileName

QString KoFileDialog::proposedFileName

Definition at line 59 of file KoFileDialog.cpp.

suffixes

QMap<QString, QString> KoFileDialog::suffixes

Definition at line 62 of file KoFileDialog.cpp.

type

KoFileDialog::DialogType KoFileDialog::type

Definition at line 55 of file KoFileDialog.cpp.

---

The documentation for this class was generated from the following files:

• libs/widgetutils/KoFileDialog.cpp
• libs/widgetutils/KoFileDialog.h