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

QgsAdvancedDigitizingDockWidget *	cadDockWidget () const
	Returns the associated CAD dock widget (e.g. 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...

QgsMessageBar *	mainMessageBar ()
	Returns the main message bar. 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	setCadDockWidget (QgsAdvancedDigitizingDockWidget *cadDockWidget)
	Sets the associated CAD dock widget, cadDockWidget, (e.g. 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	setMainMessageBar (QgsMessageBar *messageBar)
	Set current messageBar as the main message bar. 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 40 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 69 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 47 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 62 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 79 of file qgsattributeeditorcontext.h.

◆ QgsAttributeEditorContext() [3/3]

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

inline

Definition at line 92 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 218 of file qgsattributeeditorcontext.h.

◆ attributeFormMode()

Mode QgsAttributeEditorContext::attributeFormMode ( ) const

inline

Returns current attributeFormMode.

Since: QGIS 3.4

Definition at line 249 of file qgsattributeeditorcontext.h.

◆ attributeFormModeString()

QString QgsAttributeEditorContext::attributeFormModeString ( ) const

inline

Returns given attributeFormMode as string.

Since: QGIS 3.4

Definition at line 261 of file qgsattributeeditorcontext.h.

◆ cadDockWidget()

QgsAdvancedDigitizingDockWidget* QgsAttributeEditorContext::cadDockWidget ( ) const

inline

Returns the associated CAD dock widget (e.g.

to be used in map tools).

Note: Unstable API. This method is unstable API and may be modified or removed at any time.

See also: setCadDockWidget()

Since: QGIS 3.10

Definition at line 155 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 125 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 236 of file qgsattributeeditorcontext.h.

◆ formMode()

FormMode QgsAttributeEditorContext::formMode ( ) const

inline

Returns the form mode.

See also: setFormMode()

Definition at line 203 of file qgsattributeeditorcontext.h.

◆ mainMessageBar()

QgsMessageBar* QgsAttributeEditorContext::mainMessageBar ( )

inline

Returns the main message bar.

Since: QGIS 3.12

Definition at line 277 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 139 of file qgsattributeeditorcontext.h.

◆ parentContext()

const QgsAttributeEditorContext* QgsAttributeEditorContext::parentContext ( ) const

inline

Definition at line 229 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 189 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 197 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 227 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 255 of file qgsattributeeditorcontext.h.

◆ setCadDockWidget()

void QgsAttributeEditorContext::setCadDockWidget ( QgsAdvancedDigitizingDockWidget * cadDockWidget )

Sets the associated CAD dock widget, cadDockWidget, (e.g.

to be used in map tools).

Note: Unstable API. This method is unstable API and may be modified or removed at any time.

See also: cadDockWidget()

Since: QGIS 3.10

Definition at line 18 of file qgsattributeeditorcontext.cpp.

◆ 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 111 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 243 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 211 of file qgsattributeeditorcontext.h.

◆ setMainMessageBar()

void QgsAttributeEditorContext::setMainMessageBar ( QgsMessageBar * messageBar )

inline

Set current messageBar as the main message bar.

Since: QGIS 3.12

Definition at line 271 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 132 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 181 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 163 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 171 of file qgsattributeeditorcontext.h.

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

/build/qgis-3.12.1+28bionic/src/gui/qgsattributeeditorcontext.h
/build/qgis-3.12.1+28bionic/src/gui/qgsattributeeditorcontext.cpp

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()

◆ cadDockWidget()

◆ distanceArea()

◆ formFeature()

◆ formMode()

◆ mainMessageBar()

◆ mapCanvas()

◆ parentContext()

◆ relation()

◆ relationMode()

◆ setAllowCustomUi()

◆ setAttributeFormMode()

◆ setCadDockWidget()

◆ setDistanceArea()

◆ setFormFeature()

◆ setFormMode()

◆ setMainMessageBar()

◆ setMapCanvas()

◆ setRelation()

◆ setVectorLayerTools()

◆ vectorLayerTools()