QgsExpressionBuilderDialog Class Reference

A generic dialog for building expression strings. More...

#include <qgsexpressionbuilderdialog.h>

Inheritance diagram for QgsExpressionBuilderDialog:

Signals
void	allowEvalErrorsChanged ()
	Allow accepting expressions with evaluation errors.

Public Member Functions
	QgsExpressionBuilderDialog (QgsVectorLayer *layer, const QString &startText=QString(), QWidget *parent SIP_TRANSFERTHIS=nullptr, const QString &key="generic", const QgsExpressionContext &context=QgsExpressionContext())
bool	allowEvalErrors () const
	Allow accepting invalid expressions.
QString	expectedOutputFormat ()
	Returns the expected format string, which is shown in the dialog.
QgsExpressionBuilderWidget *	expressionBuilder ()
	The builder widget that is used by the dialog.
QgsExpressionContext	expressionContext () const
	Returns the expression context for the dialog.
QString	expressionText ()
void	setAllowEvalErrors (bool allowEvalErrors)
	Allow accepting expressions with evaluation errors.
void	setExpectedOutputFormat (const QString &expected)
	Set the expected format string, which is shown in the dialog.
void	setExpressionContext (const QgsExpressionContext &context)
	Sets the expression context for the dialog.
void	setExpressionText (const QString &text)
void	setGeomCalculator (const QgsDistanceArea &da)
	Sets geometry calculator used in distance/area calculations.

Protected Member Functions
void	accept () override
void	done (int r) override
	Is called when the dialog get accepted or rejected Used to save geometry.
void	reject () override

Properties
bool	allowEvalErrors

Detailed Description

A generic dialog for building expression strings.

Definition at line 30 of file qgsexpressionbuilderdialog.h.

Constructor & Destructor Documentation

QgsExpressionBuilderDialog()

QgsExpressionBuilderDialog::QgsExpressionBuilderDialog	(	QgsVectorLayer *	layer,
		const QString &	startText = QString(),
		QWidget *parent	SIP_TRANSFERTHIS = nullptr,
		const QString &	key = "generic",
		const QgsExpressionContext &	context = QgsExpressionContext() )

Definition at line 26 of file qgsexpressionbuilderdialog.cpp.

Member Function Documentation

accept()

void QgsExpressionBuilderDialog::accept ( )

overrideprotected

Definition at line 87 of file qgsexpressionbuilderdialog.cpp.

allowEvalErrors()

bool QgsExpressionBuilderDialog::allowEvalErrors

(

)

const

Allow accepting invalid expressions.

This can be useful when we are not able to provide an expression context of which we are sure it's completely populated.

Definition at line 128 of file qgsexpressionbuilderdialog.cpp.

allowEvalErrorsChanged

void QgsExpressionBuilderDialog::allowEvalErrorsChanged ( )

signal

Allow accepting expressions with evaluation errors.

This can be useful when we are not able to provide an expression context of which we are sure it's completely populated.

done()

void QgsExpressionBuilderDialog::done ( int r )

overrideprotected

Is called when the dialog get accepted or rejected Used to save geometry.

Parameters

r	result value (unused)

Definition at line 82 of file qgsexpressionbuilderdialog.cpp.

expectedOutputFormat()

QString QgsExpressionBuilderDialog::expectedOutputFormat

(

)

Returns the expected format string, which is shown in the dialog.

This is purely a text format and no expression validation is done against it.

See also

setExpectedOutputFormat()

Definition at line 62 of file qgsexpressionbuilderdialog.cpp.

expressionBuilder()

QgsExpressionBuilderWidget * QgsExpressionBuilderDialog::expressionBuilder

(

)

The builder widget that is used by the dialog.

Definition at line 47 of file qgsexpressionbuilderdialog.cpp.

expressionContext()

QgsExpressionContext QgsExpressionBuilderDialog::expressionContext

(

)

const

Returns the expression context for the dialog.

The context is used for the expression preview result and for populating the list of available functions and variables.

See also

setExpressionContext

Definition at line 72 of file qgsexpressionbuilderdialog.cpp.

expressionText()

QString QgsExpressionBuilderDialog::expressionText

(

)

Definition at line 57 of file qgsexpressionbuilderdialog.cpp.

reject()

void QgsExpressionBuilderDialog::reject ( )

overrideprotected

Definition at line 93 of file qgsexpressionbuilderdialog.cpp.

setAllowEvalErrors()

void QgsExpressionBuilderDialog::setAllowEvalErrors

(

bool

allowEvalErrors

)

Allow accepting expressions with evaluation errors.

This can be useful when we are not able to provide an expression context of which we are sure it's completely populated.

Definition at line 133 of file qgsexpressionbuilderdialog.cpp.

setExpectedOutputFormat()

void QgsExpressionBuilderDialog::setExpectedOutputFormat

(

const QString &

expected

)

Set the expected format string, which is shown in the dialog.

This is purely a text format and no expression validation is done against it.

See also

expectedOutputFormat()

Definition at line 67 of file qgsexpressionbuilderdialog.cpp.

setExpressionContext()

void QgsExpressionBuilderDialog::setExpressionContext

(

const QgsExpressionContext &

context

)

Sets the expression context for the dialog.

The context is used for the expression preview result and for populating the list of available functions and variables.

Parameters

context

expression context

See also

expressionContext

Definition at line 77 of file qgsexpressionbuilderdialog.cpp.

setExpressionText()

void QgsExpressionBuilderDialog::setExpressionText

(

const QString &

text

)

Definition at line 52 of file qgsexpressionbuilderdialog.cpp.

setGeomCalculator()

void QgsExpressionBuilderDialog::setGeomCalculator

(

const QgsDistanceArea &

da

)

Sets geometry calculator used in distance/area calculations.

Definition at line 122 of file qgsexpressionbuilderdialog.cpp.

Property Documentation

allowEvalErrors

bool QgsExpressionBuilderDialog::allowEvalErrors

readwrite

Definition at line 34 of file qgsexpressionbuilderdialog.h.

---

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

• /build/qgis-3.99.0+git20251210+2fe06baccd8+99sid/src/gui/qgsexpressionbuilderdialog.h
• /build/qgis-3.99.0+git20251210+2fe06baccd8+99sid/src/gui/qgsexpressionbuilderdialog.cpp