Class: QgsAttributeEditorRelation

class qgis.core.QgsAttributeEditorRelation

Bases: QgsAttributeEditorElement

This element will load a relation editor onto the form.

QgsAttributeEditorRelation(name: str, relationId: str, parent: QgsAttributeEditorElement)

Deprecated since version QGIS: 3.0.2. The name parameter is not used for anything and overwritten by the relationId internally.

QgsAttributeEditorRelation(name: str, relation: QgsRelation, parent: QgsAttributeEditorElement)

Deprecated since version QGIS: 3.0.2. The name parameter is not used for anything and overwritten by the relationId internally.

QgsAttributeEditorRelation(relationId: str, parent: QgsAttributeEditorElement) Creates a new element which embeds a relation.

Parameters:
  • relationId – The id of the relation to embed

  • parent – The parent (used as container)

QgsAttributeEditorRelation(relation: QgsRelation, parent: QgsAttributeEditorElement) Creates a new element which embeds a relation.

Parameters:
  • relation – The relation to embed

  • parent – The parent (used as container)

QgsAttributeEditorRelation(QgsAttributeEditorRelation)

Methods

clone

param parent:

forceSuppressFormPopup

Determines the force suppress form popup status.

init

Initializes the relation from the id

label

Determines the label of this element

nmRelationId

Determines the relation id of the second relation involved in an N:M relation.

relation

Gets the id of the relation which shall be embedded

relationEditorConfiguration

Returns the relation editor widget configuration

relationWidgetTypeId

Returns the current relation widget type id

setForceSuppressFormPopup

Sets force suppress form popup status to forceSuppressFormPopup.

setLabel

Sets label for this element If it's empty it takes the relation id as label

setNmRelationId

Sets nmRelationId for the relation id of the second relation involved in an N:M relation.

setRelationEditorConfiguration

Sets the relation editor configuration

setRelationWidgetTypeId

Sets the relation widget type

Attributes

AddChildFeature

AllButtons

DeleteChildFeature

DuplicateChildFeature

Link

SaveChildEdits

Unlink

ZoomToChildFeature

staticMetaObject

AddChildFeature = 16
AllButtons = 254
class Button

Bases: int

baseClass

alias of QgsAttributeEditorRelation

class Buttons
class Buttons(Union[QgsAttributeEditorRelation.Buttons, QgsAttributeEditorRelation.Button])
class Buttons(QgsAttributeEditorRelation.Buttons)

Bases: sip.wrapper

baseClass

alias of QgsAttributeEditorRelation

DeleteChildFeature = 64
DuplicateChildFeature = 32
SaveChildEdits = 8
ZoomToChildFeature = 128
clone(self, parent: QgsAttributeEditorElement) QgsAttributeEditorElement
Parameters:

parent (QgsAttributeEditorElement) –

Return type:

QgsAttributeEditorElement

forceSuppressFormPopup(self) bool

Determines the force suppress form popup status.

New in version 3.16.

Return type:

bool

init(self, relManager: QgsRelationManager) bool

Initializes the relation from the id

Parameters:

relManager (QgsRelationManager) – The relation manager to use for the initialization

Return type:

bool

Returns:

True if the relation was found in the relationmanager

label(self) str

Determines the label of this element

New in version 3.16.

Return type:

str

nmRelationId(self) Any

Determines the relation id of the second relation involved in an N:M relation.

New in version 3.16.

Return type:

Any

relation(self) QgsRelation

Gets the id of the relation which shall be embedded

Return type:

QgsRelation

Returns:

the id

relationEditorConfiguration(self) Dict[str, Any]

Returns the relation editor widget configuration

New in version 3.18.

Return type:

Dict[str, Any]

relationWidgetTypeId(self) str

Returns the current relation widget type id

New in version 3.18.

Return type:

str

setForceSuppressFormPopup(self, forceSuppressFormPopup: bool)

Sets force suppress form popup status to forceSuppressFormPopup. This flag is to override the layer and general settings regarding the automatic opening of the attribute form dialog when digitizing is completed.

New in version 3.16.

Parameters:

forceSuppressFormPopup (bool) –

setLabel(self, label: str = '')

Sets label for this element If it’s empty it takes the relation id as label

New in version 3.16.

Parameters:

label (str = '') –

setNmRelationId(self, nmRelationId: Any = None)

Sets nmRelationId for the relation id of the second relation involved in an N:M relation. If it’s empty, then it’s considered as a 1:M relationship.

New in version 3.16.

Parameters:

nmRelationId (Any = None) –

setRelationEditorConfiguration(self, config: Dict[str, Any])

Sets the relation editor configuration

New in version 3.18.

Parameters:

config (Dict[str) –

setRelationWidgetTypeId(self, relationWidgetTypeId: str)

Sets the relation widget type

New in version 3.18.

Parameters:

relationWidgetTypeId (str) –

staticMetaObject = <PyQt5.QtCore.QMetaObject object>