A widget for selecting a file or a folder. More...

#include <qgsfilewidget.h>

Inheritance diagram for QgsFileWidget:

[legend]

Public Types
enum	RelativeStorage { Absolute , RelativeProject , RelativeDefaultPath }
	The RelativeStorage enum determines if path is absolute, relative to the current project path or relative to a defined default path. More...
enum	StorageMode { GetFile , GetDirectory , GetMultipleFiles , SaveFile }
	The StorageMode enum determines if the file picker should pick files or directories. More...

Signals
void	fileChanged (const QString &path)
	Emitted whenever the current file or directory path is changed.

Public Member Functions
	QgsFileWidget (QWidget *parent=nullptr)
	QgsFileWidget creates a widget for selecting a file or a folder.
bool	confirmOverwrite () const
	Returns whether a confirmation will be shown when overwriting an existing file.
QString	defaultRoot () const
	Returns the default root path.
QString	dialogTitle () const
	Returns the open file dialog title.
QString	filePath () const
	Returns the current file path(s).
bool	fileWidgetButtonVisible () const
	Returns `true` if the tool button is shown.
QString	filter () const
	returns the filters used for QDialog::getOpenFileName
bool	fullUrl () const
	Returns `true` if the links shown use the full path.
QgsFilterLineEdit *	lineEdit ()
	Returns a pointer to the widget's line edit, which can be used to customize the appearance and behavior of the line edit portion of the widget.
QSize	minimumSizeHint () const override
QFileDialog::Options	options () const
	Returns the additional options used for QFileDialog.
QgsFileWidget::RelativeStorage	relativeStorage () const
	Returns if the relative path is with respect to the project path or the default path.
QString	selectedFilter () const
	Returns the selected filter from the last opened file dialog.
void	setConfirmOverwrite (bool confirmOverwrite)
	Sets whether a confirmation to overwrite an existing file will appear.
void	setDefaultRoot (const QString &defaultRoot)
	Returns the default root path used as the first shown location when picking a file and used if the RelativeStorage is RelativeDefaultPath.
void	setDialogTitle (const QString &title)
	Sets the title to use for the open file dialog.
void	setFilePath (const QString &path)
	Sets the current file path.
void	setFileWidgetButtonVisible (bool visible)
	Sets whether the tool button is visible.
void	setFilter (const QString &filter)
	setFilter sets the filter used by the model to filters.
void	setFullUrl (bool fullUrl)
	Sets whether links shown use the full path.
void	setOptions (QFileDialog::Options options)
	Set additional options used for QFileDialog.
virtual void	setReadOnly (bool readOnly)
	Sets whether the widget should be read only.
void	setRelativeStorage (QgsFileWidget::RelativeStorage relativeStorage)
	Sets whether the relative path is with respect to the project path or the default path.
void	setSelectedFilter (const QString &selectedFilter)
	Sets the selected filter when the file dialog opens.
void	setStorageMode (QgsFileWidget::StorageMode storageMode)
	Sets the widget's storage mode (i.e.
void	setUseLink (bool useLink)
	Sets whether the file path will be shown as a link.
QgsFileWidget::StorageMode	storageMode () const
	Returns the widget's storage mode (i.e.
bool	useLink () const
	Returns `true` if the file path will be shown as a link.

Static Public Member Functions
static QStringList	splitFilePaths (const QString &path)
	Split the the quoted and space separated path and returns a list of strings.

Protected Member Functions
QString	relativePath (const QString &filePath, bool removeRelative) const
	Returns a filePath with relative path options applied (or not) !
void	setFilePaths (const QStringList &filePaths)
	Update filePath according to filePaths list.
virtual void	setSelectedFileNames (QStringList fileNames)
	Called whenever user select fileNames from dialog.
QString	toUrl (const QString &path) const
	returns a HTML code with a link to the given file path
virtual void	updateLayout ()
	Update buttons visibility.

Static Protected Member Functions
static bool	isMultiFiles (const QString &path)
	Returns true if path is a multifiles.

Protected Attributes
bool	mButtonVisible = true
bool	mConfirmOverwrite = true
QString	mDefaultRoot
QString	mDialogTitle
QString	mFilePath
QToolButton *	mFileWidgetButton = nullptr
QString	mFilter
bool	mFullUrl = false
bool	mIsLinkEdited = false
QHBoxLayout *	mLayout = nullptr
QgsFileDropEdit *	mLineEdit = nullptr
QToolButton *	mLinkEditButton = nullptr
QLabel *	mLinkLabel = nullptr
QFileDialog::Options	mOptions = QFileDialog::Options()
bool	mReadOnly = false
RelativeStorage	mRelativeStorage = Absolute
QString	mSelectedFilter
StorageMode	mStorageMode = GetFile
bool	mUseLink = false

Properties
QString	defaultRoot
QString	dialogTitle
bool	fileWidgetButtonVisible
QString	filter
bool	fullUrl
QFileDialog::Options	options
RelativeStorage	relativeStorage
StorageMode	storageMode
bool	useLink

Friends
class	TestQgsExternalResourceWidgetWrapper
class	TestQgsExternalStorageFileWidget
class	TestQgsFileWidget

Detailed Description

A widget for selecting a file or a folder.

Definition at line 37 of file qgsfilewidget.h.

Member Enumeration Documentation

◆ RelativeStorage

enum QgsFileWidget::RelativeStorage

The RelativeStorage enum determines if path is absolute, relative to the current project path or relative to a defined default path.

Enumerator
Absolute
RelativeProject
RelativeDefaultPath

Definition at line 76 of file qgsfilewidget.h.

◆ StorageMode

enum QgsFileWidget::StorageMode

The StorageMode enum determines if the file picker should pick files or directories.

Enumerator
GetFile	Select a single file.
GetDirectory	Select a directory.
GetMultipleFiles	Select multiple files.
SaveFile	Select a single new or pre-existing file.

Definition at line 64 of file qgsfilewidget.h.

Constructor & Destructor Documentation

◆ QgsFileWidget()

QgsFileWidget::QgsFileWidget ( QWidget * parent = nullptr )

explicit

QgsFileWidget creates a widget for selecting a file or a folder.

Definition at line 38 of file qgsfilewidget.cpp.

Member Function Documentation

◆ confirmOverwrite()

bool QgsFileWidget::confirmOverwrite ( ) const

inline

Returns whether a confirmation will be shown when overwriting an existing file.

See also: setConfirmOverwrite()

Definition at line 195 of file qgsfilewidget.h.

◆ defaultRoot()

QString QgsFileWidget::defaultRoot ( ) const

Returns the default root path.

See also: setDefaultRoot()

Definition at line 249 of file qgsfilewidget.cpp.

◆ dialogTitle()

QString QgsFileWidget::dialogTitle ( ) const

Returns the open file dialog title.

See also: setDialogTitle()

Definition at line 146 of file qgsfilewidget.cpp.

◆ fileChanged

void QgsFileWidget::fileChanged ( const QString & path )

signal

Emitted whenever the current file or directory path is changed.

◆ filePath()

QString QgsFileWidget::filePath ( ) const

Returns the current file path(s).

When multiple files are selected they are quoted and separated by a single space (for example: '"/path/foo" "path/bar"')

See also: setFilePath(); splitFilePaths()

Definition at line 79 of file qgsfilewidget.cpp.

◆ fileWidgetButtonVisible()

bool QgsFileWidget::fileWidgetButtonVisible ( ) const

Returns true if the tool button is shown.

See also: setFileWidgetButtonVisible()

Definition at line 177 of file qgsfilewidget.cpp.

◆ filter()

QString QgsFileWidget::filter ( ) const

returns the filters used for QDialog::getOpenFileName

Definition at line 156 of file qgsfilewidget.cpp.

◆ fullUrl()

bool QgsFileWidget::fullUrl ( ) const

Returns true if the links shown use the full path.

See also: setFullUrl()

Definition at line 239 of file qgsfilewidget.cpp.

◆ isMultiFiles()

bool QgsFileWidget::isMultiFiles ( const QString & path )

staticprotected

Returns true if path is a multifiles.

Definition at line 188 of file qgsfilewidget.cpp.

◆ lineEdit()

QgsFilterLineEdit * QgsFileWidget::lineEdit ( )

Returns a pointer to the widget's line edit, which can be used to customize the appearance and behavior of the line edit portion of the widget.

Definition at line 280 of file qgsfilewidget.cpp.

◆ minimumSizeHint()

QSize QgsFileWidget::minimumSizeHint ( ) const

override

Definition at line 470 of file qgsfilewidget.cpp.

◆ options()

QFileDialog::Options QgsFileWidget::options ( ) const

Returns the additional options used for QFileDialog.

See also: setOptions()

Since: QGIS 3.14

Definition at line 167 of file qgsfilewidget.cpp.

◆ relativePath()

QString QgsFileWidget::relativePath	(	const QString &	filePath,
		bool	removeRelative ) const

protected

Returns a filePath with relative path options applied (or not) !

Definition at line 443 of file qgsfilewidget.cpp.

◆ relativeStorage()

QgsFileWidget::RelativeStorage QgsFileWidget::relativeStorage ( ) const

Returns if the relative path is with respect to the project path or the default path.

See also: setRelativeStorage()

Definition at line 270 of file qgsfilewidget.cpp.

◆ selectedFilter()

QString QgsFileWidget::selectedFilter ( ) const

inline

Returns the selected filter from the last opened file dialog.

See also: setSelectedFilter()

Definition at line 177 of file qgsfilewidget.h.

◆ setConfirmOverwrite()

void QgsFileWidget::setConfirmOverwrite ( bool confirmOverwrite )

inline

Sets whether a confirmation to overwrite an existing file will appear.

By default, a confirmation will appear.

Parameters

confirmOverwrite If set to true, an overwrite confirmation will be shown

See also: confirmOverwrite()

Definition at line 188 of file qgsfilewidget.h.

◆ setDefaultRoot()

void QgsFileWidget::setDefaultRoot ( const QString & defaultRoot )

Returns the default root path used as the first shown location when picking a file and used if the RelativeStorage is RelativeDefaultPath.

See also: defaultRoot()

Definition at line 254 of file qgsfilewidget.cpp.

◆ setDialogTitle()

void QgsFileWidget::setDialogTitle ( const QString & title )

Sets the title to use for the open file dialog.

Note: If not defined, the title is "Select a file" or "Select a directory" or "Select one or more files" depending on the configuration.

See also: dialogTitle()

Definition at line 151 of file qgsfilewidget.cpp.

◆ setFilePath()

void QgsFileWidget::setFilePath ( const QString & path )

Sets the current file path.

See also: filePath()

Definition at line 130 of file qgsfilewidget.cpp.

◆ setFilePaths()

void QgsFileWidget::setFilePaths ( const QStringList & filePaths )

protected

Update filePath according to filePaths list.

Definition at line 424 of file qgsfilewidget.cpp.

◆ setFileWidgetButtonVisible()

void QgsFileWidget::setFileWidgetButtonVisible ( bool visible )

Sets whether the tool button is visible.

See also: fileWidgetButtonVisible()

Definition at line 182 of file qgsfilewidget.cpp.

◆ setFilter()

void QgsFileWidget::setFilter ( const QString & filter )

setFilter sets the filter used by the model to filters.

The filter is used to specify the kind of files that should be shown.

Parameters

filter Only files that match the given filter are shown, it may be an empty string. If you want multiple filters, separate them with ';;',

Definition at line 161 of file qgsfilewidget.cpp.

◆ setFullUrl()

void QgsFileWidget::setFullUrl ( bool fullUrl )

Sets whether links shown use the full path.

See also: fullUrl()

Definition at line 244 of file qgsfilewidget.cpp.

◆ setOptions()

void QgsFileWidget::setOptions ( QFileDialog::Options options )

Set additional options used for QFileDialog.

These options affect the look and feel of the QFileDialog shown when a user is interactively browsing for paths.

See also: options()

Since: QGIS 3.14

Definition at line 172 of file qgsfilewidget.cpp.

◆ setReadOnly()

void QgsFileWidget::setReadOnly ( bool readOnly )

virtual

Sets whether the widget should be read only.

Reimplemented in QgsExternalStorageFileWidget.

Definition at line 136 of file qgsfilewidget.cpp.

◆ setRelativeStorage()

void QgsFileWidget::setRelativeStorage ( QgsFileWidget::RelativeStorage relativeStorage )

Sets whether the relative path is with respect to the project path or the default path.

See also: relativeStorage()

Definition at line 275 of file qgsfilewidget.cpp.

◆ setSelectedFileNames()

void QgsFileWidget::setSelectedFileNames ( QStringList fileNames )

protectedvirtual

Called whenever user select fileNames from dialog.

Reimplemented in QgsExternalStorageFileWidget.

Definition at line 411 of file qgsfilewidget.cpp.

◆ setSelectedFilter()

void QgsFileWidget::setSelectedFilter ( const QString & selectedFilter )

inline

Sets the selected filter when the file dialog opens.

See also: selectedFilter()

Definition at line 170 of file qgsfilewidget.h.

◆ setStorageMode()

void QgsFileWidget::setStorageMode ( QgsFileWidget::StorageMode storageMode )

Sets the widget's storage mode (i.e.

file or directory).

See also: storageMode()

Definition at line 264 of file qgsfilewidget.cpp.

◆ setUseLink()

void QgsFileWidget::setUseLink ( bool useLink )

Sets whether the file path will be shown as a link.

See also: useLink()

Definition at line 230 of file qgsfilewidget.cpp.

◆ splitFilePaths()

QStringList QgsFileWidget::splitFilePaths ( const QString & path )

static

Split the the quoted and space separated path and returns a list of strings.

See also: filePath()

Definition at line 84 of file qgsfilewidget.cpp.

◆ storageMode()

QgsFileWidget::StorageMode QgsFileWidget::storageMode ( ) const

Returns the widget's storage mode (i.e.

file or directory).

See also: setStorageMode()

Definition at line 259 of file qgsfilewidget.cpp.

◆ toUrl()

QString QgsFileWidget::toUrl ( const QString & path ) const

protected

returns a HTML code with a link to the given file path

Definition at line 480 of file qgsfilewidget.cpp.

◆ updateLayout()

void QgsFileWidget::updateLayout ( )

protectedvirtual

Update buttons visibility.

Reimplemented in QgsExternalStorageFileWidget.

Definition at line 285 of file qgsfilewidget.cpp.

◆ useLink()

bool QgsFileWidget::useLink ( ) const

Returns true if the file path will be shown as a link.

See also: setUseLink()

Definition at line 225 of file qgsfilewidget.cpp.

◆ TestQgsExternalResourceWidgetWrapper

friend class TestQgsExternalResourceWidgetWrapper

friend

Definition at line 355 of file qgsfilewidget.h.

◆ TestQgsExternalStorageFileWidget

friend class TestQgsExternalStorageFileWidget

friend

Definition at line 354 of file qgsfilewidget.h.

◆ TestQgsFileWidget

friend class TestQgsFileWidget

friend

Definition at line 353 of file qgsfilewidget.h.

Member Data Documentation

◆ mButtonVisible

bool QgsFileWidget::mButtonVisible = true

protected

Definition at line 323 of file qgsfilewidget.h.

◆ mConfirmOverwrite

bool QgsFileWidget::mConfirmOverwrite = true

protected

Definition at line 332 of file qgsfilewidget.h.

◆ mDefaultRoot

QString QgsFileWidget::mDefaultRoot

protected

Definition at line 331 of file qgsfilewidget.h.

◆ mDialogTitle

QString QgsFileWidget::mDialogTitle

protected

Definition at line 328 of file qgsfilewidget.h.

◆ mFilePath

QString QgsFileWidget::mFilePath

protected

Definition at line 322 of file qgsfilewidget.h.

◆ mFileWidgetButton

QToolButton* QgsFileWidget::mFileWidgetButton = nullptr

protected

Definition at line 340 of file qgsfilewidget.h.

◆ mFilter

QString QgsFileWidget::mFilter

protected

Definition at line 329 of file qgsfilewidget.h.

◆ mFullUrl

bool QgsFileWidget::mFullUrl = false

protected

Definition at line 325 of file qgsfilewidget.h.

◆ mIsLinkEdited

bool QgsFileWidget::mIsLinkEdited = false

protected

Definition at line 327 of file qgsfilewidget.h.

◆ mLayout

QHBoxLayout* QgsFileWidget::mLayout = nullptr

protected

Definition at line 341 of file qgsfilewidget.h.

◆ mLineEdit

QgsFileDropEdit* QgsFileWidget::mLineEdit = nullptr

protected

Definition at line 338 of file qgsfilewidget.h.

◆ mLinkEditButton

QToolButton* QgsFileWidget::mLinkEditButton = nullptr

protected

Definition at line 339 of file qgsfilewidget.h.

◆ mLinkLabel

QLabel* QgsFileWidget::mLinkLabel = nullptr

protected

Definition at line 337 of file qgsfilewidget.h.

◆ mOptions

QFileDialog::Options QgsFileWidget::mOptions = QFileDialog::Options()

protected

Definition at line 335 of file qgsfilewidget.h.

◆ mReadOnly

bool QgsFileWidget::mReadOnly = false

protected

Definition at line 326 of file qgsfilewidget.h.

◆ mRelativeStorage

RelativeStorage QgsFileWidget::mRelativeStorage = Absolute

protected

Definition at line 334 of file qgsfilewidget.h.

◆ mSelectedFilter

QString QgsFileWidget::mSelectedFilter

protected

Definition at line 330 of file qgsfilewidget.h.

◆ mStorageMode

StorageMode QgsFileWidget::mStorageMode = GetFile

protected

Definition at line 333 of file qgsfilewidget.h.

◆ mUseLink

bool QgsFileWidget::mUseLink = false

protected

Definition at line 324 of file qgsfilewidget.h.

Property Documentation

◆ defaultRoot

QString QgsFileWidget::defaultRoot

readwrite

Definition at line 54 of file qgsfilewidget.h.

◆ dialogTitle

QString QgsFileWidget::dialogTitle

readwrite

Definition at line 52 of file qgsfilewidget.h.

◆ fileWidgetButtonVisible

bool QgsFileWidget::fileWidgetButtonVisible

readwrite

Definition at line 49 of file qgsfilewidget.h.

◆ filter

QString QgsFileWidget::filter

readwrite

Definition at line 53 of file qgsfilewidget.h.

◆ fullUrl

bool QgsFileWidget::fullUrl

readwrite

Definition at line 51 of file qgsfilewidget.h.

◆ options

QFileDialog::Options QgsFileWidget::options

readwrite

Definition at line 57 of file qgsfilewidget.h.

◆ relativeStorage

RelativeStorage QgsFileWidget::relativeStorage

readwrite

Definition at line 56 of file qgsfilewidget.h.

◆ storageMode

StorageMode QgsFileWidget::storageMode

readwrite

Definition at line 55 of file qgsfilewidget.h.

◆ useLink

bool QgsFileWidget::useLink

readwrite

Definition at line 50 of file qgsfilewidget.h.

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

/build/qgis-3.99.0+git20251205+26c88405ac0+99sid/src/gui/qgsfilewidget.h
/build/qgis-3.99.0+git20251205+26c88405ac0+99sid/src/gui/qgsfilewidget.cpp

Public Types

Signals

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Properties

Friends

Detailed Description

Member Enumeration Documentation

◆ RelativeStorage

◆ StorageMode

Constructor & Destructor Documentation

◆ QgsFileWidget()

Member Function Documentation

◆ confirmOverwrite()

◆ defaultRoot()

◆ dialogTitle()

◆ fileChanged

◆ filePath()

◆ fileWidgetButtonVisible()

◆ filter()

◆ fullUrl()

◆ isMultiFiles()

◆ lineEdit()

◆ minimumSizeHint()

◆ options()

◆ relativePath()

◆ relativeStorage()

◆ selectedFilter()

◆ setConfirmOverwrite()

◆ setDefaultRoot()

◆ setDialogTitle()

◆ setFilePath()

◆ setFilePaths()

◆ setFileWidgetButtonVisible()

◆ setFilter()

◆ setFullUrl()

◆ setOptions()

◆ setReadOnly()

◆ setRelativeStorage()

◆ setSelectedFileNames()

◆ setSelectedFilter()

◆ setStorageMode()

◆ setUseLink()

◆ splitFilePaths()

◆ storageMode()

◆ toUrl()

◆ updateLayout()

◆ useLink()

Friends And Related Symbol Documentation

◆ TestQgsExternalResourceWidgetWrapper

◆ TestQgsExternalStorageFileWidget

◆ TestQgsFileWidget

Member Data Documentation

◆ mButtonVisible

◆ mConfirmOverwrite

◆ mDefaultRoot

◆ mDialogTitle

◆ mFilePath

◆ mFileWidgetButton

◆ mFilter

◆ mFullUrl

◆ mIsLinkEdited

◆ mLayout

◆ mLineEdit

◆ mLinkEditButton

◆ mLinkLabel

◆ mOptions

◆ mReadOnly

◆ mRelativeStorage

◆ mSelectedFilter

◆ mStorageMode

◆ mUseLink

Property Documentation

◆ defaultRoot

◆ dialogTitle

◆ fileWidgetButtonVisible

◆ filter