QGIS API Documentation  3.2.0-Bonn (bc43194)
Public Types | Public Slots | Public Member Functions | Static Public Member Functions | Protected Slots | Protected Attributes | Properties | List of all members
QgsFieldModel Class Reference

The QgsFieldModel class is a model to display the list of fields of a layer in widgets. More...

#include <qgsfieldmodel.h>

Inheritance diagram for QgsFieldModel:
Inheritance graph
[legend]

Public Types

enum  FieldRoles {
  FieldNameRole = Qt::UserRole + 1, FieldIndexRole = Qt::UserRole + 2, ExpressionRole = Qt::UserRole + 3, IsExpressionRole = Qt::UserRole + 4,
  ExpressionValidityRole = Qt::UserRole + 5, FieldTypeRole = Qt::UserRole + 6, FieldOriginRole = Qt::UserRole + 7, IsEmptyRole = Qt::UserRole + 8
}
 Roles utilized by the model. More...
 

Public Slots

void setLayer (QgsVectorLayer *layer)
 Set the layer from which fields are displayed. More...
 

Public Member Functions

 QgsFieldModel (QObject *parent=nullptr)
 Constructor for QgsFieldModel - creates a model to display the fields of a given layer. More...
 
bool allowEmptyFieldName () const
 Returns true if the model allows the empty field ("not set") choice. More...
 
bool allowExpression ()
 Returns true if the model allows custom expressions to be created and displayed. More...
 
int columnCount (const QModelIndex &parent) const override
 
QVariant data (const QModelIndex &index, int role) const override
 
QModelIndex index (int row, int column, const QModelIndex &parent=QModelIndex()) const override
 
QModelIndex indexFromName (const QString &fieldName)
 Returns the index corresponding to a given fieldName. More...
 
bool isField (const QString &expression) const
 Returns true if a string represents a field reference, or false if it is an expression consisting of more than direct field reference. More...
 
QgsVectorLayerlayer ()
 Returns the layer associated with the model. More...
 
QModelIndex parent (const QModelIndex &child) const override
 
void removeExpression ()
 Removes any custom expression from the model. More...
 
int rowCount (const QModelIndex &parent=QModelIndex()) const override
 
void setAllowEmptyFieldName (bool allowEmpty)
 Sets whether an optional empty field ("not set") option is present in the model. More...
 
void setAllowExpression (bool allowExpression)
 Sets whether custom expressions are accepted and displayed in the model. More...
 
void setExpression (const QString &expression)
 Sets a single expression to be added after the fields at the end of the model. More...
 

Static Public Member Functions

static QString fieldToolTip (const QgsField &field)
 Returns a HTML formatted tooltip string for a field, containing details like the field name, alias and type. More...
 

Protected Slots

virtual void updateModel ()
 Called when the model must be updated. More...
 

Protected Attributes

bool mAllowEmpty = false
 
bool mAllowExpression = false
 
QList< QString > mExpression
 
QgsFields mFields
 
QgsVectorLayermLayer = nullptr
 

Properties

bool allowEmptyFieldName
 
bool allowExpression
 
QgsVectorLayer layer
 

Detailed Description

The QgsFieldModel class is a model to display the list of fields of a layer in widgets.

If allowed, expressions might be added to the end of the model. It can be associated with a QgsMapLayerModel to dynamically display a layer and its fields.

Since
QGIS 2.3

Definition at line 37 of file qgsfieldmodel.h.

Member Enumeration Documentation

◆ FieldRoles

Roles utilized by the model.

Enumerator
FieldNameRole 

Return field name if index corresponds to a field.

FieldIndexRole 

Return field index if index corresponds to a field.

ExpressionRole 

Return field name or expression.

IsExpressionRole 

Return if index corresponds to an expression.

ExpressionValidityRole 

Return if expression is valid or not.

FieldTypeRole 

Return the field type (if a field, return QVariant if expression)

FieldOriginRole 

Return the field origin (if a field, returns QVariant if expression)

IsEmptyRole 

Return if the index corresponds to the empty value.

Definition at line 48 of file qgsfieldmodel.h.

Constructor & Destructor Documentation

◆ QgsFieldModel()

QgsFieldModel::QgsFieldModel ( QObject *  parent = nullptr)
explicit

Constructor for QgsFieldModel - creates a model to display the fields of a given layer.

Definition at line 26 of file qgsfieldmodel.cpp.

Member Function Documentation

◆ allowEmptyFieldName()

bool QgsFieldModel::allowEmptyFieldName ( ) const
inline

Returns true if the model allows the empty field ("not set") choice.

See also
setAllowEmptyFieldName()
Since
QGIS 3.0

Definition at line 95 of file qgsfieldmodel.h.

◆ allowExpression()

bool QgsFieldModel::allowExpression ( )
inline

Returns true if the model allows custom expressions to be created and displayed.

See also
setAllowExpression()

Definition at line 81 of file qgsfieldmodel.h.

◆ columnCount()

int QgsFieldModel::columnCount ( const QModelIndex &  parent) const
override

Definition at line 263 of file qgsfieldmodel.cpp.

◆ data()

QVariant QgsFieldModel::data ( const QModelIndex &  index,
int  role 
) const
override

Definition at line 269 of file qgsfieldmodel.cpp.

◆ fieldToolTip()

QString QgsFieldModel::fieldToolTip ( const QgsField field)
static

Returns a HTML formatted tooltip string for a field, containing details like the field name, alias and type.

Since
QGIS 3.0

Definition at line 435 of file qgsfieldmodel.cpp.

◆ index()

QModelIndex QgsFieldModel::index ( int  row,
int  column,
const QModelIndex &  parent = QModelIndex() 
) const
override

Definition at line 237 of file qgsfieldmodel.cpp.

◆ indexFromName()

QModelIndex QgsFieldModel::indexFromName ( const QString &  fieldName)

Returns the index corresponding to a given fieldName.

Definition at line 31 of file qgsfieldmodel.cpp.

◆ isField()

bool QgsFieldModel::isField ( const QString &  expression) const

Returns true if a string represents a field reference, or false if it is an expression consisting of more than direct field reference.

Definition at line 73 of file qgsfieldmodel.cpp.

◆ layer()

QgsVectorLayer* QgsFieldModel::layer ( )
inline

Returns the layer associated with the model.

See also
setLayer()

Definition at line 122 of file qgsfieldmodel.h.

◆ parent()

QModelIndex QgsFieldModel::parent ( const QModelIndex &  child) const
override

Definition at line 247 of file qgsfieldmodel.cpp.

◆ removeExpression()

void QgsFieldModel::removeExpression ( )

Removes any custom expression from the model.

See also
setExpression()
allowExpression()

Definition at line 230 of file qgsfieldmodel.cpp.

◆ rowCount()

int QgsFieldModel::rowCount ( const QModelIndex &  parent = QModelIndex()) const
override

Definition at line 253 of file qgsfieldmodel.cpp.

◆ setAllowEmptyFieldName()

void QgsFieldModel::setAllowEmptyFieldName ( bool  allowEmpty)

Sets whether an optional empty field ("not set") option is present in the model.

See also
allowEmptyFieldName()
Since
QGIS 3.0

Definition at line 194 of file qgsfieldmodel.cpp.

◆ setAllowExpression()

void QgsFieldModel::setAllowExpression ( bool  allowExpression)

Sets whether custom expressions are accepted and displayed in the model.

See also
allowExpression()
setExpression()

Definition at line 177 of file qgsfieldmodel.cpp.

◆ setExpression()

void QgsFieldModel::setExpression ( const QString &  expression)

Sets a single expression to be added after the fields at the end of the model.

See also
setAllowExpression()
allowExpression()
removeExpression()

Definition at line 214 of file qgsfieldmodel.cpp.

◆ setLayer

void QgsFieldModel::setLayer ( QgsVectorLayer layer)
slot

Set the layer from which fields are displayed.

See also
layer()

Definition at line 79 of file qgsfieldmodel.cpp.

◆ updateModel

void QgsFieldModel::updateModel ( )
protectedvirtualslot

Called when the model must be updated.

Definition at line 104 of file qgsfieldmodel.cpp.

Member Data Documentation

◆ mAllowEmpty

bool QgsFieldModel::mAllowEmpty = false
protected

Definition at line 162 of file qgsfieldmodel.h.

◆ mAllowExpression

bool QgsFieldModel::mAllowExpression = false
protected

Definition at line 161 of file qgsfieldmodel.h.

◆ mExpression

QList<QString> QgsFieldModel::mExpression
protected

Definition at line 158 of file qgsfieldmodel.h.

◆ mFields

QgsFields QgsFieldModel::mFields
protected

Definition at line 157 of file qgsfieldmodel.h.

◆ mLayer

QgsVectorLayer* QgsFieldModel::mLayer = nullptr
protected

Definition at line 160 of file qgsfieldmodel.h.

Property Documentation

◆ allowEmptyFieldName

bool QgsFieldModel::allowEmptyFieldName
readwrite

Definition at line 42 of file qgsfieldmodel.h.

◆ allowExpression

bool QgsFieldModel::allowExpression
readwrite

Definition at line 41 of file qgsfieldmodel.h.

◆ layer

QgsVectorLayer QgsFieldModel::layer
readwrite

Definition at line 43 of file qgsfieldmodel.h.


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