This class contains context information for attribute editor widgets. More...

#include <qgsattributeeditorcontext.h>

Public Types
enum	FormMode { Embed, StandaloneDialog, Popup }

enum	Mode { SingleEditMode, AddFeatureMode, MultiEditMode, SearchMode, AggregateSearchMode, IdentifyMode }
	modes More...

enum	RelationMode { Undefined, Multiple, Single }
	Determines in which direction a relation was resolved. More...

Public Member Functions
	QgsAttributeEditorContext ()=default
	Constructor for QgsAttributeEditorContext. More...

	QgsAttributeEditorContext (const QgsAttributeEditorContext &parentContext, FormMode formMode)

	QgsAttributeEditorContext (const QgsAttributeEditorContext &parentContext, const QgsRelation &relation, RelationMode relationMode, FormMode widgetMode)

bool	allowCustomUi () const
	Returns `true` if the attribute editor should permit use of custom UI forms. More...

Mode	attributeFormMode () const
	Returns current attributeFormMode. More...

QString	attributeFormModeString () const
	Returns given attributeFormMode as string. More...

const QgsDistanceArea &	distanceArea () const
	Returns the distance area object used for area/length calculations. More...

QgsFeature	formFeature () const
	Returns current feature from the currently edited form or table row. More...

FormMode	formMode () const
	Returns the form mode. More...

QgsMapCanvas *	mapCanvas () const
	Returns the associated map canvas (e.g. More...

const QgsAttributeEditorContext *	parentContext () const

const QgsRelation &	relation () const
	Returns the attribute relation. More...

RelationMode	relationMode () const
	Returns the attribute relation mode. More...

void	setAllowCustomUi (bool allow)
	Sets whether the attribute editor should permit use of custom UI forms. More...

void	setAttributeFormMode (const Mode &attributeFormMode)
	Set attributeFormMode for the edited form. More...

void	setDistanceArea (const QgsDistanceArea &distanceArea)
	Sets distance area object, distanceArea, for area/length calculations. More...

void	setFormFeature (const QgsFeature &feature)
	Set current feature for the currently edited form or table row. More...

void	setFormMode (FormMode mode)
	Sets the form mode. More...

void	setMapCanvas (QgsMapCanvas *mapCanvas)
	Sets the associated map canvas, mapCanvas, (e.g. More...

void	setRelation (const QgsRelation &relation, RelationMode mode)
	Set attribute relation and mode. More...

void	setVectorLayerTools (QgsVectorLayerTools *vlTools)
	Sets the associated vector layer tools. More...

const QgsVectorLayerTools *	vectorLayerTools () const
	Returns the associated vector layer tools. More...

Detailed Description

This class contains context information for attribute editor widgets.

It will be passed to embedded widgets whenever this occurs (e.g. when showing an embedded form due to relations)

Definition at line 38 of file qgsattributeeditorcontext.h.

Member Enumeration Documentation

◆ FormMode

enum QgsAttributeEditorContext::FormMode

Enumerator
Embed	A form was embedded as a widget on another form.
StandaloneDialog	A form was opened as a new dialog.
Popup	A widget was opened as a popup (e.g. attribute table editor widget)

Definition at line 67 of file qgsattributeeditorcontext.h.

◆ Mode

enum QgsAttributeEditorContext::Mode

modes

Enumerator
SingleEditMode	Single edit mode, for editing a single feature.
AddFeatureMode	Add feature mode, for setting attributes for a new feature. In this mode the dialog will be editable even with an invalid feature and will add a new feature when the form is accepted.
MultiEditMode	Multi edit mode, for editing fields of multiple features at once.
SearchMode	Form values are used for searching/filtering the layer.
AggregateSearchMode	Form is in aggregate search mode, show each widget in this mode. Since QGIS 3.0
IdentifyMode	Identify the feature. Since QGIS 3.0

Definition at line 45 of file qgsattributeeditorcontext.h.

◆ RelationMode

enum QgsAttributeEditorContext::RelationMode

Determines in which direction a relation was resolved.

Enumerator
Undefined	This context is not defined by a relation.
Multiple	When showing a list of features (e.g. houses as an embedded form in a district form)
Single	When showing a single feature (e.g. district information when looking at the form of a house)

Definition at line 60 of file qgsattributeeditorcontext.h.

Constructor & Destructor Documentation

◆ QgsAttributeEditorContext() [1/3]

QgsAttributeEditorContext::QgsAttributeEditorContext ( )

default

Constructor for QgsAttributeEditorContext.

◆ QgsAttributeEditorContext() [2/3]

QgsAttributeEditorContext::QgsAttributeEditorContext	(	const QgsAttributeEditorContext &	parentContext,
		FormMode	formMode
	)

inline

Definition at line 77 of file qgsattributeeditorcontext.h.

◆ QgsAttributeEditorContext() [3/3]

QgsAttributeEditorContext::QgsAttributeEditorContext	(	const QgsAttributeEditorContext &	parentContext,
		const QgsRelation &	relation,
		RelationMode	relationMode,
		FormMode	widgetMode
	)

inline

Definition at line 88 of file qgsattributeeditorcontext.h.

Member Function Documentation

◆ allowCustomUi()

bool QgsAttributeEditorContext::allowCustomUi ( ) const

inline

Returns true if the attribute editor should permit use of custom UI forms.

See also: setAllowCustomUi()

Since: QGIS 2.16

Definition at line 196 of file qgsattributeeditorcontext.h.

◆ attributeFormMode()

Mode QgsAttributeEditorContext::attributeFormMode ( ) const

inline

Returns current attributeFormMode.

Since: QGIS 3.4

Definition at line 227 of file qgsattributeeditorcontext.h.

◆ attributeFormModeString()

QString QgsAttributeEditorContext::attributeFormModeString ( ) const

inline

Returns given attributeFormMode as string.

Since: QGIS 3.4

Definition at line 239 of file qgsattributeeditorcontext.h.

◆ distanceArea()

const QgsDistanceArea& QgsAttributeEditorContext::distanceArea ( ) const

inline

Returns the distance area object used for area/length calculations.

See also: setDistanceArea()

Since: QGIS 2.2

Definition at line 119 of file qgsattributeeditorcontext.h.

◆ formFeature()

QgsFeature QgsAttributeEditorContext::formFeature ( ) const

inline

Returns current feature from the currently edited form or table row.

See also: setFormFeature()

Since: QGIS 3.2

Definition at line 214 of file qgsattributeeditorcontext.h.

◆ formMode()

FormMode QgsAttributeEditorContext::formMode ( ) const

inline

Returns the form mode.

See also: setFormMode()

Definition at line 181 of file qgsattributeeditorcontext.h.

◆ mapCanvas()

QgsMapCanvas* QgsAttributeEditorContext::mapCanvas ( ) const

inline

Returns the associated map canvas (e.g.

to zoom to related features).

See also: setMapCanvas()

Since: QGIS 3.2

Definition at line 133 of file qgsattributeeditorcontext.h.

◆ parentContext()

const QgsAttributeEditorContext* QgsAttributeEditorContext::parentContext ( ) const

inline

Definition at line 207 of file qgsattributeeditorcontext.h.

◆ relation()

const QgsRelation& QgsAttributeEditorContext::relation ( ) const

inline

Returns the attribute relation.

See also: setRelation(); relationMode()

Since: QGIS 2.6

Definition at line 167 of file qgsattributeeditorcontext.h.

◆ relationMode()

RelationMode QgsAttributeEditorContext::relationMode ( ) const

inline

Returns the attribute relation mode.

See also: setRelation(); relation()

Since: QGIS 2.6

Definition at line 175 of file qgsattributeeditorcontext.h.

◆ setAllowCustomUi()

void QgsAttributeEditorContext::setAllowCustomUi ( bool allow )

inline

Sets whether the attribute editor should permit use of custom UI forms.

Parameters

allow set to true to allow custom UI forms, or false to disable them and use default generated QGIS forms

See also: allowCustomUi()

Since: QGIS 2.16

Definition at line 205 of file qgsattributeeditorcontext.h.

◆ setAttributeFormMode()

void QgsAttributeEditorContext::setAttributeFormMode ( const Mode & attributeFormMode )

inline

Set attributeFormMode for the edited form.

Since: QGIS 3.4

Definition at line 233 of file qgsattributeeditorcontext.h.

◆ setDistanceArea()

void QgsAttributeEditorContext::setDistanceArea ( const QgsDistanceArea & distanceArea )

inline

Sets distance area object, distanceArea, for area/length calculations.

See also: distanceArea()

Since: QGIS 2.2

Definition at line 105 of file qgsattributeeditorcontext.h.

◆ setFormFeature()

void QgsAttributeEditorContext::setFormFeature ( const QgsFeature & feature )

inline

Set current feature for the currently edited form or table row.

See also: formFeature()

Since: QGIS 3.2

Definition at line 221 of file qgsattributeeditorcontext.h.

◆ setFormMode()

void QgsAttributeEditorContext::setFormMode ( FormMode mode )

inline

Sets the form mode.

Parameters

mode form mode

See also: formMode()

Since: QGIS 2.16

Definition at line 189 of file qgsattributeeditorcontext.h.

◆ setMapCanvas()

void QgsAttributeEditorContext::setMapCanvas ( QgsMapCanvas * mapCanvas )

inline

Sets the associated map canvas, mapCanvas, (e.g.

to zoom to related features).

See also: mapCanvas()

Since: QGIS 3.2

Definition at line 126 of file qgsattributeeditorcontext.h.

◆ setRelation()

void QgsAttributeEditorContext::setRelation	(	const QgsRelation &	relation,
		RelationMode	mode
	)

inline

Set attribute relation and mode.

Parameters

relation	relation
mode	relation mode

See also: relation(); relationMode()

Since: QGIS 2.6

Definition at line 159 of file qgsattributeeditorcontext.h.

◆ setVectorLayerTools()

void QgsAttributeEditorContext::setVectorLayerTools ( QgsVectorLayerTools * vlTools )

inline

Sets the associated vector layer tools.

Parameters

vlTools vector layer tools

See also: vectorLayerTools()

Since: QGIS 2.2

Definition at line 141 of file qgsattributeeditorcontext.h.

◆ vectorLayerTools()

const QgsVectorLayerTools* QgsAttributeEditorContext::vectorLayerTools ( ) const

inline

Returns the associated vector layer tools.

See also: setVectorLayerTools()

Since: QGIS 2.2

Definition at line 149 of file qgsattributeeditorcontext.h.

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

/tmp/buildd/qgis-3.8.0+99unstable/src/gui/qgsattributeeditorcontext.h

Public Types

Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ FormMode

◆ Mode

◆ RelationMode

Constructor & Destructor Documentation

◆ QgsAttributeEditorContext() [1/3]

◆ QgsAttributeEditorContext() [2/3]

◆ QgsAttributeEditorContext() [3/3]

Member Function Documentation

◆ allowCustomUi()

◆ attributeFormMode()

◆ attributeFormModeString()

◆ distanceArea()

◆ formFeature()

◆ formMode()

◆ mapCanvas()

◆ parentContext()

◆ relation()

◆ relationMode()

◆ setAllowCustomUi()

◆ setAttributeFormMode()

◆ setDistanceArea()

◆ setFormFeature()

◆ setFormMode()

◆ setMapCanvas()

◆ setRelation()

◆ setVectorLayerTools()

◆ vectorLayerTools()