KRecentDirs Namespace

Header: #include <KRecentDirs>
CMake: find_package(KF6 REQUIRED COMPONENTS KIO)
target_link_libraries(mytarget PRIVATE KF6::KIOCore)

Functions

void add(const QString &fileClass, const QString &directory)
QString dir(const QString &fileClass)
QStringList list(const QString &fileClass)

Detailed Description

The goal of this namespace is to make sure that, when the user needs to specify a file via the file selection dialog, this dialog will start in the directory most likely to contain the desired files.

This works as follows: Each time the file selection dialog is shown, the programmer can specify a "file-class". The file-dialog will then start with the directory associated with this file-class. When the dialog closes, the directory currently shown in the file-dialog will be associated with the file-class.

A file-class can either start with ':' or with '::'. If it starts with a single ':' the file-class is specific to the current application. If the file-class starts with '::' it is global to all applications.

Function Documentation

void KRecentDirs::add(const QString &fileClass, const QString &directory)

Associates directory with fileClass

QString KRecentDirs::dir(const QString &fileClass)

Returns the most recently used directory associated with this file-class.

QStringList KRecentDirs::list(const QString &fileClass)

Returns a list of directories associated with this file-class. The most recently used directory is at the front of the list.