QLineEdit subclass with built in support for clearing the widget's value and handling custom null value representations. More...

#include <qgsfilterlineedit.h>

Inheritance diagram for QgsFilterLineEdit:

[legend]

Public Types
enum	ClearMode { ClearToNull = 0 , ClearToDefault }
	Behavior when clearing value of widget. More...

Public Slots
virtual void	clearValue ()
	Clears the widget and resets it to the null value.

void	restoreState ()
	Restores the current state of the line edit (selection and cursor position)

void	storeState ()
	Stores the current state of the line edit (selection and cursor position)

Signals
void	cleared ()
	Emitted when the widget is cleared.

void	selectOnFocusChanged ()
	Will select all text when this widget receives the focus.

void	showSpinnerChanged ()
	Show a spinner icon.

void	valueChanged (const QString &value)
	Same as textChanged() but with support for null values.

Public Member Functions
	QgsFilterLineEdit (QWidget *parent=nullptr, const QString &nullValue=QString())
	Constructor for QgsFilterLineEdit.

ClearMode	clearMode () const
	Returns the clear mode for the widget.

QString	defaultValue () const
	Returns the default value for the widget.

bool	event (QEvent *event) override
	Reimplemented to enable/disable the clear action depending on read-only status.

bool	hasStateStored () const
	Returns if a state is already saved.

bool	isNull () const
	Determine if the current text represents null.

QString	nullValue () const
	Returns the string used for representing null values in the widget.

bool	selectOnFocus () const
	Will select all text when this widget receives the focus.

void	setClearMode (ClearMode mode)
	Sets the clear mode for the widget.

void	setDefaultValue (const QString &defaultValue)
	Sets the default value for the widget.

void	setNullValue (const QString &nullValue)
	Sets the string representation for null values in the widget.

void	setSelectOnFocus (bool selectOnFocus)
	Will select all text when this widget receives the focus.

void	setShowClearButton (bool visible)
	Sets whether the widget's clear button is visible.

void	setShowSearchIcon (bool visible)
	Define if a search icon shall be shown on the left of the image when no text is entered.

void	setShowSpinner (bool showSpinner)
	Show a spinner icon.

void	setValue (const QString &value)
	Sets the current text for the widget with support for handling null values.

bool	showClearButton () const
	Returns `true` if the widget's clear button is visible.

bool	showSearchIcon () const
	Returns if a search icon shall be shown on the left of the image when no text is entered.

bool	showSpinner () const
	Show a spinner icon.

QString	value () const
	Returns the text of this edit with support for handling null values.

Protected Member Functions
void	focusInEvent (QFocusEvent *e) override

void	mouseReleaseEvent (QMouseEvent *e) override

Properties
ClearMode	clearMode

QString	defaultValue

QString	nullValue

bool	showClearButton

bool	showSearchIcon

bool	showSpinner

QString	value

Friends
class	TestQgsFeatureListComboBox

Detailed Description

QLineEdit subclass with built in support for clearing the widget's value and handling custom null value representations.

When using QgsFilterLineEdit the value(), setValue() and clearValue() methods should be used instead of QLineEdit's text(), setText() and clear() methods, and the valueChanged() signal should be used instead of textChanged().

Definition at line 39 of file qgsfilterlineedit.h.

Member Enumeration Documentation

◆ ClearMode

enum QgsFilterLineEdit::ClearMode

Behavior when clearing value of widget.

Enumerator
ClearToNull	Reset value to null.
ClearToDefault	Reset value to default value (see defaultValue() )

Definition at line 63 of file qgsfilterlineedit.h.

Constructor & Destructor Documentation

◆ QgsFilterLineEdit()

QgsFilterLineEdit::QgsFilterLineEdit	(	QWidget *	parent = `nullptr`,
		const QString &	nullValue = `QString()`
	)

Constructor for QgsFilterLineEdit.

Parameters

parent	parent widget
nullValue	string for representing null values

Definition at line 30 of file qgsfilterlineedit.cpp.

Member Function Documentation

◆ cleared

void QgsFilterLineEdit::cleared ( )

signal

Emitted when the widget is cleared.

See also: clearValue()

◆ clearMode()

ClearMode QgsFilterLineEdit::clearMode ( ) const

inline

Returns the clear mode for the widget.

The clear mode defines the behavior of the widget when its value is cleared. This defaults to ClearToNull.

See also: setClearMode()

Definition at line 95 of file qgsfilterlineedit.h.

◆ clearValue

void QgsFilterLineEdit::clearValue ( )

virtualslot

Clears the widget and resets it to the null value.

See also: nullValue()

Definition at line 117 of file qgsfilterlineedit.cpp.

◆ defaultValue()

QString QgsFilterLineEdit::defaultValue ( ) const

inline

Returns the default value for the widget.

The default value is a value which the widget will be reset to if it is cleared and the clearMode() is equal to ClearToDefault.

See also: setDefaultValue(); clearMode()

Definition at line 150 of file qgsfilterlineedit.h.

◆ event()

bool QgsFilterLineEdit::event ( QEvent * event )

override

Reimplemented to enable/disable the clear action depending on read-only status.

Definition at line 219 of file qgsfilterlineedit.cpp.

◆ focusInEvent()

void QgsFilterLineEdit::focusInEvent ( QFocusEvent * e )

overrideprotected

Definition at line 98 of file qgsfilterlineedit.cpp.

◆ hasStateStored()

bool QgsFilterLineEdit::hasStateStored ( ) const

inline

Returns if a state is already saved.

Since: QGIS 3.14

Definition at line 216 of file qgsfilterlineedit.h.

◆ isNull()

bool QgsFilterLineEdit::isNull ( ) const

inline

Determine if the current text represents null.

Returns: true if the widget's value is null.

See also: nullValue()

Definition at line 177 of file qgsfilterlineedit.h.

◆ mouseReleaseEvent()

void QgsFilterLineEdit::mouseReleaseEvent ( QMouseEvent * e )

overrideprotected

Definition at line 107 of file qgsfilterlineedit.cpp.

◆ nullValue()

QString QgsFilterLineEdit::nullValue ( ) const

inline

Returns the string used for representing null values in the widget.

See also: setNullValue(); isNull()

Definition at line 118 of file qgsfilterlineedit.h.

◆ restoreState

void QgsFilterLineEdit::restoreState ( )

slot

Restores the current state of the line edit (selection and cursor position)

Since: QGIS 3.14

Definition at line 236 of file qgsfilterlineedit.cpp.

◆ selectOnFocus()

bool QgsFilterLineEdit::selectOnFocus ( ) const

Will select all text when this widget receives the focus.

Definition at line 160 of file qgsfilterlineedit.cpp.

◆ selectOnFocusChanged

void QgsFilterLineEdit::selectOnFocusChanged ( )

signal

Will select all text when this widget receives the focus.

◆ setClearMode()

void QgsFilterLineEdit::setClearMode ( ClearMode mode )

inline

Sets the clear mode for the widget.

The clear mode defines the behavior of the widget when its value is cleared. This defaults to ClearToNull.

See also: clearMode()

Definition at line 102 of file qgsfilterlineedit.h.

◆ setDefaultValue()

void QgsFilterLineEdit::setDefaultValue ( const QString & defaultValue )

Sets the default value for the widget.

The default value is a value which the widget will be reset to if it is cleared and the clearMode() is equal to ClearToDefault.

Parameters

defaultValue default value

See also: defaultValue(); clearMode()

Definition at line 66 of file qgsfilterlineedit.cpp.

◆ setNullValue()

void QgsFilterLineEdit::setNullValue ( const QString & nullValue )

inline

Sets the string representation for null values in the widget.

This does not affect the values returned for null values by value(), rather it only affects the text that is shown to users when the widget's value is null.

Parameters

nullValue string to show when widget's value is null

See also: nullValue()

Definition at line 111 of file qgsfilterlineedit.h.

◆ setSelectOnFocus()

void QgsFilterLineEdit::setSelectOnFocus ( bool selectOnFocus )

Will select all text when this widget receives the focus.

Definition at line 165 of file qgsfilterlineedit.cpp.

◆ setShowClearButton()

void QgsFilterLineEdit::setShowClearButton ( bool visible )

Sets whether the widget's clear button is visible.

Parameters

visible set to false to hide the clear button

See also: showClearButton()

Definition at line 44 of file qgsfilterlineedit.cpp.

◆ setShowSearchIcon()

void QgsFilterLineEdit::setShowSearchIcon ( bool visible )

Define if a search icon shall be shown on the left of the image when no text is entered.

Parameters

visible set to false to hide the search icon

Definition at line 50 of file qgsfilterlineedit.cpp.

◆ setShowSpinner()

void QgsFilterLineEdit::setShowSpinner ( bool showSpinner )

Show a spinner icon.

This can be used for search boxes to indicate that something is going on in the background.

Definition at line 179 of file qgsfilterlineedit.cpp.

◆ setValue()

void QgsFilterLineEdit::setValue ( const QString & value )

inline

Sets the current text for the widget with support for handling null values.

Parameters

value The text to set. If a null string is provided, the text shown in the widget will be set to the current nullValue().

See also: value()

Definition at line 159 of file qgsfilterlineedit.h.

◆ showClearButton()

bool QgsFilterLineEdit::showClearButton ( ) const

inline

Returns true if the widget's clear button is visible.

See also: setShowClearButton()

Definition at line 81 of file qgsfilterlineedit.h.

◆ showSearchIcon()

bool QgsFilterLineEdit::showSearchIcon ( ) const

inline

Returns if a search icon shall be shown on the left of the image when no text is entered.

Definition at line 131 of file qgsfilterlineedit.h.

◆ showSpinner()

bool QgsFilterLineEdit::showSpinner ( ) const

Show a spinner icon.

This can be used for search boxes to indicate that something is going on in the background.

Definition at line 174 of file qgsfilterlineedit.cpp.

◆ showSpinnerChanged

void QgsFilterLineEdit::showSpinnerChanged ( )

signal

Show a spinner icon.

This can be used for search boxes to indicate that something is going on in the background.

◆ storeState

void QgsFilterLineEdit::storeState ( )

slot

Stores the current state of the line edit (selection and cursor position)

Since: QGIS 3.14

Definition at line 227 of file qgsfilterlineedit.cpp.

◆ value()

QString QgsFilterLineEdit::value ( ) const

inline

Returns the text of this edit with support for handling null values.

If the text in the widget matches the current nullValue() then the returned value will be a null string.

Returns: Current text (or null string if it matches the nullValue() property )

See also: setValue()

Definition at line 169 of file qgsfilterlineedit.h.

◆ valueChanged

void QgsFilterLineEdit::valueChanged ( const QString & value )

signal

Same as textChanged() but with support for null values.

Parameters

value The current text or null string if it matches the nullValue() property.

Friends And Related Symbol Documentation

◆ TestQgsFeatureListComboBox

friend class TestQgsFeatureListComboBox

friend

Definition at line 309 of file qgsfilterlineedit.h.

Property Documentation

◆ clearMode

ClearMode QgsFilterLineEdit::clearMode

readwrite

Definition at line 52 of file qgsfilterlineedit.h.

◆ defaultValue

QString QgsFilterLineEdit::defaultValue

readwrite

Definition at line 54 of file qgsfilterlineedit.h.

◆ nullValue

QString QgsFilterLineEdit::nullValue

readwrite

Definition at line 53 of file qgsfilterlineedit.h.

◆ showClearButton

bool QgsFilterLineEdit::showClearButton

readwrite

Definition at line 56 of file qgsfilterlineedit.h.

◆ showSearchIcon

bool QgsFilterLineEdit::showSearchIcon

readwrite

Definition at line 57 of file qgsfilterlineedit.h.

◆ showSpinner

bool QgsFilterLineEdit::showSpinner

readwrite

Definition at line 58 of file qgsfilterlineedit.h.

◆ value

QString QgsFilterLineEdit::value

readwrite

Definition at line 55 of file qgsfilterlineedit.h.

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

/build/qgis-3.41.0+git20241122+3440c17df1d+99sid/src/gui/qgsfilterlineedit.h
/build/qgis-3.41.0+git20241122+3440c17df1d+99sid/src/gui/qgsfilterlineedit.cpp

Public Types

Public Slots

Signals

Public Member Functions

Protected Member Functions

Properties

Friends

Detailed Description

Member Enumeration Documentation

◆ ClearMode

Constructor & Destructor Documentation

◆ QgsFilterLineEdit()

Member Function Documentation

◆ cleared

◆ clearMode()

◆ clearValue

◆ defaultValue()

◆ event()

◆ focusInEvent()

◆ hasStateStored()

◆ isNull()

◆ mouseReleaseEvent()

◆ nullValue()

◆ restoreState

◆ selectOnFocus()

◆ selectOnFocusChanged

◆ setClearMode()

◆ setDefaultValue()

◆ setNullValue()

◆ setSelectOnFocus()

◆ setShowClearButton()

◆ setShowSearchIcon()

◆ setShowSpinner()

◆ setValue()

◆ showClearButton()

◆ showSearchIcon()

◆ showSpinner()

◆ showSpinnerChanged

◆ storeState

◆ value()

◆ valueChanged

Friends And Related Symbol Documentation

◆ TestQgsFeatureListComboBox

Property Documentation

◆ clearMode

◆ defaultValue

◆ nullValue

◆ showClearButton

◆ showSearchIcon

◆ showSpinner

◆ value