QGIS API Documentation  3.2.0-Bonn (bc43194)
Public Types | Public Member Functions | List of all members
QgsAttributeEditorContext Class Reference

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

#include <qgsattributeeditorcontext.h>

Public Types

enum  FormMode { Embed, StandaloneDialog, Popup }
 
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...
 
const QgsDistanceAreadistanceArea () 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...
 
QgsMapCanvasmapCanvas () const
 Returns the associated map canvas (e.g. More...
 
const QgsAttributeEditorContextparentContext () const
 
const QgsRelationrelation () 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 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 QgsVectorLayerToolsvectorLayerTools () 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 37 of file qgsattributeeditorcontext.h.

Member Enumeration Documentation

◆ 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 51 of file qgsattributeeditorcontext.h.

◆ 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 44 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 61 of file qgsattributeeditorcontext.h.

◆ QgsAttributeEditorContext() [3/3]

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

Definition at line 72 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 180 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 103 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 198 of file qgsattributeeditorcontext.h.

◆ formMode()

FormMode QgsAttributeEditorContext::formMode ( ) const
inline

Returns the form mode.

See also
setFormMode()

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

◆ parentContext()

const QgsAttributeEditorContext* QgsAttributeEditorContext::parentContext ( ) const
inline

Definition at line 191 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 151 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 159 of file qgsattributeeditorcontext.h.

◆ setAllowCustomUi()

void QgsAttributeEditorContext::setAllowCustomUi ( bool  allow)
inline

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

Parameters
allowset 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 189 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 89 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 205 of file qgsattributeeditorcontext.h.

◆ setFormMode()

void QgsAttributeEditorContext::setFormMode ( FormMode  mode)
inline

Sets the form mode.

Parameters
modeform mode
See also
formMode()
Since
QGIS 2.16

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

◆ setRelation()

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

Set attribute relation and mode.

Parameters
relationrelation
moderelation mode
See also
relation()
relationMode()
Since
QGIS 2.6

Definition at line 143 of file qgsattributeeditorcontext.h.

◆ setVectorLayerTools()

void QgsAttributeEditorContext::setVectorLayerTools ( QgsVectorLayerTools vlTools)
inline

Sets the associated vector layer tools.

Parameters
vlToolsvector layer tools
See also
vectorLayerTools()
Since
QGIS 2.2

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


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