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

#include <qgsexpressionbuilderdialog.h>

Inheritance diagram for QgsExpressionBuilderDialog:

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

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. More...

QString	expectedOutputFormat ()
	Returns the expected format string, which is shown in the dialog. More...

QgsExpressionBuilderWidget *	expressionBuilder ()
	The builder widget that is used by the dialog. More...

QgsExpressionContext	expressionContext () const
	Returns the expression context for the dialog. More...

QString	expressionText ()

void	setAllowEvalErrors (bool allowEvalErrors)
	Allow accepting expressions with evaluation errors. More...

void	setExpectedOutputFormat (const QString &expected)
	Set the expected format string, which is shown in the dialog. More...

void	setExpressionContext (const QgsExpressionContext &context)
	Sets the expression context for the dialog. More...

void	setExpressionText (const QString &text)

void	setGeomCalculator (const QgsDistanceArea &da)
	Sets geometry calculator used in distance/area calculations. More...

Protected Member Functions
void	accept () override

void	done (int r) override
	Is called when the dialog get accepted or rejected Used to save geometry. More...

Properties
bool	allowEvalErrors

Detailed Description

A generic dialog for building expression strings.

Remarks: This class also shows an example on how to use QgsExpressionBuilderWidget

Definition at line 30 of file qgsexpressionbuilderdialog.h.

Constructor & Destructor Documentation

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

Definition at line 21 of file qgsexpressionbuilderdialog.cpp.

Member Function Documentation

void QgsExpressionBuilderDialog::accept ( )

overrideprotected

Definition at line 80 of file qgsexpressionbuilderdialog.cpp.

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.

Since: QGIS 3.0

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.

Since: QGIS 3.0

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 75 of file qgsexpressionbuilderdialog.cpp.

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 55 of file qgsexpressionbuilderdialog.cpp.

QgsExpressionBuilderWidget * QgsExpressionBuilderDialog::expressionBuilder ( )

The builder widget that is used by the dialog.

Definition at line 40 of file qgsexpressionbuilderdialog.cpp.

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

Since: QGIS 2.12

Definition at line 65 of file qgsexpressionbuilderdialog.cpp.

QString QgsExpressionBuilderDialog::expressionText ( )

Definition at line 50 of file qgsexpressionbuilderdialog.cpp.

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.

Since: QGIS 3.0

Definition at line 97 of file qgsexpressionbuilderdialog.cpp.

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 60 of file qgsexpressionbuilderdialog.cpp.

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

Since: QGIS 2.12

Definition at line 70 of file qgsexpressionbuilderdialog.cpp.

void QgsExpressionBuilderDialog::setExpressionText ( const QString & text )

Definition at line 45 of file qgsexpressionbuilderdialog.cpp.

void QgsExpressionBuilderDialog::setGeomCalculator ( const QgsDistanceArea & da )

Sets geometry calculator used in distance/area calculations.

Definition at line 86 of file qgsexpressionbuilderdialog.cpp.

Property Documentation

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.4.15+24xenial/src/gui/qgsexpressionbuilderdialog.h
/build/qgis-3.4.15+24xenial/src/gui/qgsexpressionbuilderdialog.cpp

Signals

Public Member Functions

Protected Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Property Documentation