A wrapper around QFileDialog which remembers selected paths. More...

#include <filedialog.h>

Inheritance diagram for FileDialog:

Collaboration diagram for FileDialog:

Static Public Member Functions
static QString	getOpenFileName (QWidget *parent, FileType fileType, const QString &caption=QString())
	Shows a file dialog which allows the user to select a file to open.

static QStringList	getOpenFileNames (QWidget *parent, FileType fileType, const QString &caption=QString())
	Shows a file dialog which allows the user to select multiple files to open.

static QString	getSaveFileName (QWidget *parent, FileType fileType, const QString &caption=QString())
	Shows a file dialog which allows the user to select a file save path.

static QString	getLastOpenPath (FileType fileType)
	Retrieves the last opened file of a given type.

static void	setLastOpenPath (FileType fileType, const QString &openPath)
	Saves the last opened file of a given type.

static QString	getLastSavePath (FileType fileType)
	Retrieves the last used save path for a given file type.

static void	setLastSavePath (FileType fileType, const QString &savePath)
	Saves the last used save path for a given file type.

Static Public Member Functions inherited from QObject
QString	tr (const char sourceText, const char disambiguation, int n)

QString	trUtf8 (const char sourceText, const char disambiguation, int n)

QMetaObject::Connection	connect (const QObject sender, const char signal, const QObject receiver, const char method, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject sender, PointerToMemberFunction signal, const QObject receiver, PointerToMemberFunction method, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)

QMetaObject::Connection	connect (const QObject sender, PointerToMemberFunction signal, const QObject context, Functor functor, Qt::ConnectionType type)

bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char method)

bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method)

bool	disconnect (const QMetaObject::Connection &connection)

bool	disconnect (const QObject sender, PointerToMemberFunction signal, const QObject receiver, PointerToMemberFunction method)

Static Private Member Functions
static QString	openDialogCaption (FileType fileType)

static QString	saveDialogCaption (FileType fileType)

static QString	openFileFilters (FileType fileType)

static QString	saveFileFilters (FileType fileType)

static QString	getFilterForFile (const QString &fileType, QString filePath)

static QString	defaultFileName (FileType fileType, QString baseName=QString())

static bool	hasValidSuffix (const QString &filters, const QString &filePath)

static QString	getDefaultExtensionByFileType (FileType fileType)

static QString	toSettingKey (FileType fileType)

static void	setLastSavePaths (const QString &filePath)

Additional Inherited Members
Public Member Functions inherited from QObject
virtual const QMetaObject *	metaObject () const const

	QObject (QObject *parent)

virtual bool	event (QEvent *e)

virtual bool	eventFilter (QObject watched, QEvent event)

QString	objectName () const const

void	setObjectName (const QString &name)

bool	isWidgetType () const const

bool	isWindowType () const const

bool	signalsBlocked () const const

bool	blockSignals (bool block)

QThread *	thread () const const

void	moveToThread (QThread *targetThread)

int	startTimer (int interval, Qt::TimerType timerType)

int	startTimer (std::chrono::milliseconds time, Qt::TimerType timerType)

void	killTimer (int id)

T	findChild (const QString &name, Qt::FindChildOptions options) const const

QList< T >	findChildren (const QString &name, Qt::FindChildOptions options) const const

QList< T >	findChildren (const QRegExp &regExp, Qt::FindChildOptions options) const const

QList< T >	findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const

const QObjectList &	children () const const

void	setParent (QObject *parent)

void	installEventFilter (QObject *filterObj)

void	removeEventFilter (QObject *obj)

QMetaObject::Connection	connect (const QObject sender, const char signal, const char *method, Qt::ConnectionType type) const const

bool	disconnect (const char signal, const QObject receiver, const char *method) const const

bool	disconnect (const QObject receiver, const char method) const const

void	dumpObjectTree ()

void	dumpObjectInfo ()

void	dumpObjectTree () const const

void	dumpObjectInfo () const const

bool	setProperty (const char *name, const QVariant &value)

QVariant	property (const char *name) const const

QList< QByteArray >	dynamicPropertyNames () const const

void	destroyed (QObject *obj)

void	objectNameChanged (const QString &objectName)

QObject *	parent () const const

bool	inherits (const char *className) const const

void	deleteLater ()

	Q_DISABLE_COPY (Class)

	Q_DISABLE_MOVE (Class)

	Q_DISABLE_COPY_MOVE (Class)

T	qobject_cast (QObject *object)

T	qobject_cast (const QObject *object)

T	qFindChild (const QObject *obj, const QString &name)

QList< T >	qFindChildren (const QObject *obj, const QString &name)

QList< T >	qFindChildren (const QObject *obj, const QRegExp &regExp)

	Q_CLASSINFO (Name, Value)

	Q_INTERFACES (...)

	Q_PROPERTY (...)

	Q_ENUMS (...)

	Q_FLAGS (...)

	Q_ENUM (...)

	Q_FLAG (...)

	Q_ENUM_NS (...)

	Q_FLAG_NS (...)

	Q_OBJECT Q_OBJECT

	Q_GADGET Q_GADGET

	Q_NAMESPACE Q_NAMESPACE

	Q_NAMESPACE_EXPORT (EXPORT_MACRO)

	Q_SIGNALS Q_SIGNALS

	Q_SIGNAL Q_SIGNAL

	Q_SLOTS Q_SLOTS

	Q_SLOT Q_SLOT

	Q_EMIT Q_EMIT

	Q_INVOKABLE Q_INVOKABLE

	Q_REVISION Q_REVISION

	Q_SET_OBJECT_NAME (Object)

	QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT

Public Attributes inherited from QObject
typedef	QObjectList

Protected Member Functions inherited from QObject
QObject *	sender () const const

int	senderSignalIndex () const const

int	receivers (const char *signal) const const

bool	isSignalConnected (const QMetaMethod &signal) const const

virtual void	timerEvent (QTimerEvent *event)

virtual void	childEvent (QChildEvent *event)

virtual void	customEvent (QEvent *event)

virtual void	connectNotify (const QMetaMethod &signal)

virtual void	disconnectNotify (const QMetaMethod &signal)

Properties inherited from QObject
	objectName

Detailed Description

A wrapper around QFileDialog which remembers selected paths.

Definition at line 28 of file filedialog.h.

Member Function Documentation

◆ defaultFileName()

QString FileDialog::defaultFileName	(	FileType	fileType,
		QString	baseName = `QString()`
	)

staticprivate

Definition at line 271 of file filedialog.cpp.

◆ getDefaultExtensionByFileType()

QString FileDialog::getDefaultExtensionByFileType ( FileType fileType )

staticprivate

Definition at line 114 of file filedialog.cpp.

◆ getFilterForFile()

QString FileDialog::getFilterForFile	(	const QString &	fileType,
		QString	filePath
	)

staticprivate

Definition at line 243 of file filedialog.cpp.

◆ getLastOpenPath()

QString FileDialog::getLastOpenPath ( FileType fileType )

static

Retrieves the last opened file of a given type.

Parameters

fileType The type of file to look up

Returns: The path of the last opened file or the user's home directory if no file of that type has been opened before

See also: setLastOpenPath()

Definition at line 131 of file filedialog.cpp.

◆ getLastSavePath()

QString FileDialog::getLastSavePath ( FileType fileType )

static

Retrieves the last used save path for a given file type.

Parameters

fileType The type of file to look up

Returns: The last used save path or a file with a default name in the user's home directory if no file of that type has been saved before

See also: setLastSavePath()

Definition at line 146 of file filedialog.cpp.

◆ getOpenFileName()

QString FileDialog::getOpenFileName	(	QWidget *	parent,
		FileType	fileType,
		const QString &	caption = `QString()`
	)

static

Shows a file dialog which allows the user to select a file to open.

Parameters

parent	The parent widget
fileType	The file type to select
caption	The dialog's caption. If not specified, a default caption will be used

Returns: An existing file selected by the user or a null string if the dialog was cancelled

See also: getOpenFileNames()

Definition at line 28 of file filedialog.cpp.

◆ getOpenFileNames()

QStringList FileDialog::getOpenFileNames	(	QWidget *	parent,
		FileType	fileType,
		const QString &	caption = `QString()`
	)

static

Shows a file dialog which allows the user to select multiple files to open.

Parameters

parent	The parent widget
fileType	The file type to select
caption	The dialog's caption. If not specified, a default caption will be used

Returns: One or more existing files selected by the user or an empty list if the dialog was cancelled

See also: getOpenFileName()

Definition at line 53 of file filedialog.cpp.

◆ getSaveFileName()

QString FileDialog::getSaveFileName	(	QWidget *	parent,
		FileType	fileType,
		const QString &	caption = `QString()`
	)

static

Shows a file dialog which allows the user to select a file save path.

The file does not have to exist.

Parameters

parent	The parent widget
fileType	The file type to select
caption	The dialog's caption. If not specified, a default caption will be used

Returns: An file path selected by the user or a null string if the dialog was cancelled

Definition at line 84 of file filedialog.cpp.

◆ hasValidSuffix()

bool FileDialog::hasValidSuffix	(	const QString &	filters,
		const QString &	filePath
	)

staticprivate

Definition at line 227 of file filedialog.cpp.

◆ openDialogCaption()

QString FileDialog::openDialogCaption ( FileType fileType )

staticprivate

Definition at line 163 of file filedialog.cpp.

◆ openFileFilters()

QString FileDialog::openFileFilters ( FileType fileType )

staticprivate

Definition at line 195 of file filedialog.cpp.

◆ saveDialogCaption()

QString FileDialog::saveDialogCaption ( FileType fileType )

staticprivate

Definition at line 179 of file filedialog.cpp.

◆ saveFileFilters()

QString FileDialog::saveFileFilters ( FileType fileType )

staticprivate

Definition at line 211 of file filedialog.cpp.

◆ setLastOpenPath()

void FileDialog::setLastOpenPath	(	FileType	fileType,
		const QString &	openPath
	)

static

Saves the last opened file of a given type.

Parameters

fileType	The opened file's type
openPath	The opened file's path

See also: getLastOpenPath()

Definition at line 138 of file filedialog.cpp.

◆ setLastSavePath()

void FileDialog::setLastSavePath	(	FileType	fileType,
		const QString &	savePath
	)

static

Saves the last used save path for a given file type.

Parameters

fileType	The saved file's type
savePath	The saved file's path

See also: getLastSavePath()

Definition at line 155 of file filedialog.cpp.

◆ setLastSavePaths()

void FileDialog::setLastSavePaths ( const QString & filePath )

staticprivate

Definition at line 72 of file filedialog.cpp.

◆ toSettingKey()

QString FileDialog::toSettingKey ( FileType fileType )

staticprivate

Definition at line 286 of file filedialog.cpp.

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

app/src/filedialog.h
app/src/filedialog.cpp

Static Public Member Functions

Static Private Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ defaultFileName()

◆ getDefaultExtensionByFileType()

◆ getFilterForFile()

◆ getLastOpenPath()

◆ getLastSavePath()

◆ getOpenFileName()

◆ getOpenFileNames()

◆ getSaveFileName()

◆ hasValidSuffix()

◆ openDialogCaption()

◆ openFileFilters()

◆ saveDialogCaption()

◆ saveFileFilters()

◆ setLastOpenPath()

◆ setLastSavePath()

◆ setLastSavePaths()

◆ toSettingKey()