QGIS API Documentation  3.2.0-Bonn (bc43194)
Public Slots | Signals | Public Member Functions | Protected Member Functions | List of all members
QgsExpressionBuilderWidget Class Reference

A reusable widget that can be used to build a expression string. More...

#include <qgsexpressionbuilderwidget.h>

Inheritance diagram for QgsExpressionBuilderWidget:
Inheritance graph
[legend]

Public Slots

void autosave ()
 Auto save the current Python function code. More...
 
void loadAllValues ()
 Load all unique values from the set layer into the sample area. More...
 
void loadSampleValues ()
 Load sample values into the sample value area. More...
 
void setAutoSave (bool enabled)
 Enabled or disable auto saving. More...
 

Signals

void evalErrorChanged ()
 Will be set to true if the current expression text reported an eval error with the context. More...
 
void expressionParsed (bool isValid)
 Emitted when the user changes the expression in the widget. More...
 
void parserErrorChanged ()
 Will be set to true if the current expression text reported a parser error with the context. More...
 

Public Member Functions

 QgsExpressionBuilderWidget (QWidget *parent=nullptr)
 Create a new expression builder widget with an optional parent. More...
 
 ~QgsExpressionBuilderWidget () override
 
bool evalError () const
 Will be set to true if the current expression text reported an eval error with the context. More...
 
QString expectedOutputFormat ()
 The set expected format string. More...
 
QgsExpressionContext expressionContext () const
 Returns the expression context for the widget. More...
 
QString expressionText ()
 Gets the expression string that has been set in the expression area. More...
 
bool isExpressionValid ()
 
void loadCodeFromFile (QString path)
 Load code from the given file into the function editor. More...
 
void loadFieldNames ()
 Loads all the field names from the layer. More...
 
void loadFieldNames (const QgsFields &fields)
 
void loadFieldsAndValues (const QMap< QString, QStringList > &fieldValues)
 Loads field names and values from the specified map. More...
 
void loadFunctionCode (const QString &code)
 Load code into the function editor. More...
 
void loadRecent (const QString &collection="generic")
 Loads the recent expressions from the given collection. More...
 
QStandardItemModel * model ()
 Returns a pointer to the dialog's function item model. More...
 
void newFunctionFile (const QString &fileName="scratch")
 Create a new file in the function editor. More...
 
bool parserError () const
 Will be set to true if the current expression text reports a parser error with the context. More...
 
QgsProjectproject ()
 Returns the project currently associated with the widget. More...
 
void registerItem (const QString &group, const QString &label, const QString &expressionText, const QString &helpText=QString(), QgsExpressionItem::ItemType type=QgsExpressionItem::ExpressionNode, bool highlightedItem=false, int sortOrder=1)
 Registers a node item for the expression builder. More...
 
void saveFunctionFile (QString fileName)
 Save the current function editor text to the given file. More...
 
void saveToRecent (const QString &collection="generic")
 Adds the current expression to the given collection. More...
 
void setExpectedOutputFormat (const QString &expected)
 The set expected format string. More...
 
void setExpressionContext (const QgsExpressionContext &context)
 Sets the expression context for the widget. More...
 
void setExpressionText (const QString &expression)
 Sets the expression string for the widget. More...
 
void setGeomCalculator (const QgsDistanceArea &da)
 Sets geometry calculator used in distance/area calculations. More...
 
void setLayer (QgsVectorLayer *layer)
 Sets layer in order to get the fields and values. More...
 
void setProject (QgsProject *project)
 Sets the project currently associated with the widget. More...
 
void updateFunctionFileList (const QString &path)
 Update the list of function files found at the given path. More...
 

Protected Member Functions

void showEvent (QShowEvent *e) override
 

Detailed Description

A reusable widget that can be used to build a expression string.

See QgsExpressionBuilderDialog for example of usage.

Definition at line 133 of file qgsexpressionbuilderwidget.h.

Constructor & Destructor Documentation

◆ QgsExpressionBuilderWidget()

QgsExpressionBuilderWidget::QgsExpressionBuilderWidget ( QWidget *  parent = nullptr)

Create a new expression builder widget with an optional parent.

Definition at line 43 of file qgsexpressionbuilderwidget.cpp.

◆ ~QgsExpressionBuilderWidget()

QgsExpressionBuilderWidget::~QgsExpressionBuilderWidget ( )
override

Definition at line 151 of file qgsexpressionbuilderwidget.cpp.

Member Function Documentation

◆ autosave

void QgsExpressionBuilderWidget::autosave ( )
slot

Auto save the current Python function code.

Definition at line 1011 of file qgsexpressionbuilderwidget.cpp.

◆ evalError()

bool QgsExpressionBuilderWidget::evalError ( ) const

Will be set to true if the current expression text reported an eval error with the context.

Since
QGIS 3.0

Definition at line 758 of file qgsexpressionbuilderwidget.cpp.

◆ evalErrorChanged

void QgsExpressionBuilderWidget::evalErrorChanged ( )
signal

Will be set to true if the current expression text reported an eval error with the context.

Since
QGIS 3.0

◆ expectedOutputFormat()

QString QgsExpressionBuilderWidget::expectedOutputFormat ( )

The set expected format string.

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

Returns
The expected value format.

Definition at line 602 of file qgsexpressionbuilderwidget.cpp.

◆ expressionContext()

QgsExpressionContext QgsExpressionBuilderWidget::expressionContext ( ) const
inline

Returns the expression context for the widget.

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 197 of file qgsexpressionbuilderwidget.h.

◆ expressionParsed

void QgsExpressionBuilderWidget::expressionParsed ( bool  isValid)
signal

Emitted when the user changes the expression in the widget.

Users of this widget should connect to this signal to decide if to let the user continue.

Parameters
isValidIs true if the expression the user has typed is valid.

◆ expressionText()

QString QgsExpressionBuilderWidget::expressionText ( )

Gets the expression string that has been set in the expression area.

Returns
The expression as a string.

Definition at line 592 of file qgsexpressionbuilderwidget.cpp.

◆ isExpressionValid()

bool QgsExpressionBuilderWidget::isExpressionValid ( )

Definition at line 453 of file qgsexpressionbuilderwidget.cpp.

◆ loadAllValues

void QgsExpressionBuilderWidget::loadAllValues ( )
slot

Load all unique values from the set layer into the sample area.

Definition at line 989 of file qgsexpressionbuilderwidget.cpp.

◆ loadCodeFromFile()

void QgsExpressionBuilderWidget::loadCodeFromFile ( QString  path)

Load code from the given file into the function editor.

Definition at line 300 of file qgsexpressionbuilderwidget.cpp.

◆ loadFieldNames() [1/2]

void QgsExpressionBuilderWidget::loadFieldNames ( )

Loads all the field names from the layer.

Remarks
Should this really be public couldn't we just do this for the user?

Definition at line 329 of file qgsexpressionbuilderwidget.cpp.

◆ loadFieldNames() [2/2]

void QgsExpressionBuilderWidget::loadFieldNames ( const QgsFields fields)

Definition at line 339 of file qgsexpressionbuilderwidget.cpp.

◆ loadFieldsAndValues()

void QgsExpressionBuilderWidget::loadFieldsAndValues ( const QMap< QString, QStringList > &  fieldValues)

Loads field names and values from the specified map.

Note
The field values must be quoted appropriately if they are strings.
Since
QGIS 2.12

Definition at line 356 of file qgsexpressionbuilderwidget.cpp.

◆ loadFunctionCode()

void QgsExpressionBuilderWidget::loadFunctionCode ( const QString &  code)

Load code into the function editor.

Definition at line 308 of file qgsexpressionbuilderwidget.cpp.

◆ loadRecent()

void QgsExpressionBuilderWidget::loadRecent ( const QString &  collection = "generic")

Loads the recent expressions from the given collection.

By default it is loaded from the collection "generic".

Definition at line 476 of file qgsexpressionbuilderwidget.cpp.

◆ loadSampleValues

void QgsExpressionBuilderWidget::loadSampleValues ( )
slot

Load sample values into the sample value area.

Definition at line 976 of file qgsexpressionbuilderwidget.cpp.

◆ model()

QStandardItemModel * QgsExpressionBuilderWidget::model ( )

Returns a pointer to the dialog's function item model.

This method is exposed for testing purposes only - it should not be used to modify the model.

Since
QGIS 3.0

Definition at line 772 of file qgsexpressionbuilderwidget.cpp.

◆ newFunctionFile()

void QgsExpressionBuilderWidget::newFunctionFile ( const QString &  fileName = "scratch")

Create a new file in the function editor.

Definition at line 261 of file qgsexpressionbuilderwidget.cpp.

◆ parserError()

bool QgsExpressionBuilderWidget::parserError ( ) const

Will be set to true if the current expression text reports a parser error with the context.

Since
QGIS 3.0

Definition at line 744 of file qgsexpressionbuilderwidget.cpp.

◆ parserErrorChanged

void QgsExpressionBuilderWidget::parserErrorChanged ( )
signal

Will be set to true if the current expression text reported a parser error with the context.

Since
QGIS 3.0

◆ project()

QgsProject * QgsExpressionBuilderWidget::project ( )

Returns the project currently associated with the widget.

See also
setProject()
Since
QGIS 3.0

Definition at line 777 of file qgsexpressionbuilderwidget.cpp.

◆ registerItem()

void QgsExpressionBuilderWidget::registerItem ( const QString &  group,
const QString &  label,
const QString &  expressionText,
const QString &  helpText = QString(),
QgsExpressionItem::ItemType  type = QgsExpressionItem::ExpressionNode,
bool  highlightedItem = false,
int  sortOrder = 1 
)

Registers a node item for the expression builder.

Parameters
groupThe group the item will be show in the tree view. If the group doesn't exsit it will be created.
labelThe label that is show to the user for the item in the tree.
expressionTextThe text that is inserted into the expression area when the user double clicks on the item.
helpTextThe help text that the user will see when item is selected.
typeThe type of the expression item.
highlightedItemset to true to make the item highlighted, which inserts a bold copy of the item at the top level
sortOrdersort ranking for item

Definition at line 410 of file qgsexpressionbuilderwidget.cpp.

◆ saveFunctionFile()

void QgsExpressionBuilderWidget::saveFunctionFile ( QString  fileName)

Save the current function editor text to the given file.

Definition at line 220 of file qgsexpressionbuilderwidget.cpp.

◆ saveToRecent()

void QgsExpressionBuilderWidget::saveToRecent ( const QString &  collection = "generic")

Adds the current expression to the given collection.

By default it is saved to the collection "generic".

Definition at line 458 of file qgsexpressionbuilderwidget.cpp.

◆ setAutoSave

void QgsExpressionBuilderWidget::setAutoSave ( bool  enabled)
inlineslot

Enabled or disable auto saving.

When enabled Python scripts will be auto saved when text changes.

Parameters
enabledTrue to enable auto saving.

Definition at line 322 of file qgsexpressionbuilderwidget.h.

◆ setExpectedOutputFormat()

void QgsExpressionBuilderWidget::setExpectedOutputFormat ( const QString &  expected)

The set expected format string.

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

Parameters
expectedThe expected value format for the expression.
Note
Only a UI hint and not used for expression validation.

Definition at line 607 of file qgsexpressionbuilderwidget.cpp.

◆ setExpressionContext()

void QgsExpressionBuilderWidget::setExpressionContext ( const QgsExpressionContext context)

Sets the expression context for the widget.

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

Parameters
contextexpression context
See also
expressionContext
Since
QGIS 2.12

Definition at line 613 of file qgsexpressionbuilderwidget.cpp.

◆ setExpressionText()

void QgsExpressionBuilderWidget::setExpressionText ( const QString &  expression)

Sets the expression string for the widget.

Definition at line 597 of file qgsexpressionbuilderwidget.cpp.

◆ setGeomCalculator()

void QgsExpressionBuilderWidget::setGeomCalculator ( const QgsDistanceArea da)

Sets geometry calculator used in distance/area calculations.

Definition at line 587 of file qgsexpressionbuilderwidget.cpp.

◆ setLayer()

void QgsExpressionBuilderWidget::setLayer ( QgsVectorLayer layer)

Sets layer in order to get the fields and values.

Note
this needs to be called before calling loadFieldNames().

Definition at line 164 of file qgsexpressionbuilderwidget.cpp.

◆ setProject()

void QgsExpressionBuilderWidget::setProject ( QgsProject project)

Sets the project currently associated with the widget.

This controls which layers and relations and other project-specific items are shown in the widget.

See also
project()
Since
QGIS 3.0

Definition at line 782 of file qgsexpressionbuilderwidget.cpp.

◆ showEvent()

void QgsExpressionBuilderWidget::showEvent ( QShowEvent *  e)
overrideprotected

Definition at line 788 of file qgsexpressionbuilderwidget.cpp.

◆ updateFunctionFileList()

void QgsExpressionBuilderWidget::updateFunctionFileList ( const QString &  path)

Update the list of function files found at the given path.

Definition at line 243 of file qgsexpressionbuilderwidget.cpp.


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