Class: QgsRelationReferenceWidget

A widget which shows related features.

Class Hierarchy

Base classes

QWidget
QObject
QPaintDevice

class qgis.gui.QgsRelationReferenceWidget

Bases: QWidget

class CanvasExtent

Bases: int

Fixed = 0

Pan = 1

Scale = 2

allowAddFeatures(self) → bool

Determines if a button for adding new features should be shown.

Return type:

bool

allowMapIdentification(self) → bool

determines if the widget offers the possibility to select the related feature on the map (using a dedicated map tool)

Return type:

bool

chainFilters(self) → bool

Determines if the filters are chained

Return type:

bool

Returns:

True if filters are chained

deleteForeignKeys(self)

unset the currently related feature

embedForm(self) → bool

determines if the form of the related feature will be shown

Return type:

bool

fetchLimit(self) → int

Returns the limit of fetched features (0 means all features)

Added in version 3.32.

Return type:

int

filterExpression(self) → str

Returns the currently set filter expression.

Return type:

str

foreignKey(self) → Any

returns the related feature foreign key

Deprecated since version 3.10.

Return type:

Any

signal foreignKeyChanged

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

foreignKeys(self) → List[Any]

Returns the related feature foreign keys

Added in version 3.10.

Return type:

List[Any]

signal foreignKeysChanged

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

init(self)

mapIdentification(self)

activate the map tool to select a new related feature on the map

openForm(self)

open the form of the related feature in a new dialog

openFormButtonVisible(self) → bool

determines the open form button is visible in the widget

Return type:

bool

orderExpression(self) → str

Returns the string of the order expression The order expression will be used for sort values in the combobox.

Added in version 4.0.

Return type:

str

readOnlySelector(self) → bool

determines if the drop-down is enabled

Return type:

bool

referencedFeature(self) → QgsFeature

Returns the related feature (from the referenced layer) if no feature is related, it returns an invalid feature

Return type:

QgsFeature

referencedLayerDataSource(self) → str

Returns the public data source of the referenced layer

Added in version 3.12.

Return type:

str

referencedLayerId(self) → str

Returns the id of the referenced layer

Added in version 3.12.

Return type:

str

referencedLayerName(self) → str

Returns the name of the referenced layer

Added in version 3.12.

Return type:

str

referencedLayerProviderKey(self) → str

Returns the data provider key of the referenced layer

Added in version 3.12.

Return type:

str

relation(self) → QgsRelation

Returns the current relation, which might be invalid

Added in version 3.10.

Return type:

QgsRelation

saveReferencedAttributeForm(self) → bool

Trigger save of the embedded referenced attribute form. Returns True on success or if no embedded form is present.

Added in version 3.42.

Return type:

bool

setAllowAddFeatures(self, allowAddFeatures: bool)

Determines if a button for adding new features should be shown.

Parameters:

allowAddFeatures (bool)

setAllowMapIdentification(self, allowMapIdentification: bool)

Parameters:

allowMapIdentification (bool)

setChainFilters(self, chainFilters: bool)

Set if filters are chained. Chained filters restrict the option of subsequent filters based on the selection of a previous filter.

Parameters:

chainFilters (bool) – If chaining should be enabled

setEditorContext(self, context: QgsAttributeEditorContext, canvas: QgsMapCanvas | None, messageBar: QgsMessageBar | None)

Sets the editor context

Note

if context cadDockWidget is null, it won’t be possible to digitize the geometry of a referenced feature from this widget

Parameters:

• context (QgsAttributeEditorContext)

• canvas (Optional[QgsMapCanvas])

• messageBar (Optional[QgsMessageBar])

setEmbedForm(self, display: bool)

Parameters:

display (bool)

setFetchLimit(self, fetchLimit: int)

Set the limit of fetched features (0 means all features)

Added in version 3.32.

Parameters:

fetchLimit (int)

setFilterExpression(self, filterExpression: str | None)

If not empty, will be used as filter expression. Only if this evaluates to True, the value will be shown.

Parameters:

filterExpression (Optional[str])

setFilterFields(self, filterFields: Iterable[str | None])

Sets the fields for which filter comboboxes will be created

Parameters:

filterFields (Iterable[Optional[str]])

setForeignKey(self, value: Any)

this sets the related feature using from the foreign key

Deprecated since version 3.10: Use setForeignKeys.

Parameters:

value (Any)

setForeignKeys(self, values: Iterable[Any])

Sets the related feature using the foreign keys

Added in version 3.10.

Parameters:

values (Iterable[Any])

setFormFeature(self, formFeature: QgsFeature)

Set the current form feature (from the referencing layer)

Added in version 3.10.

Parameters:

formFeature (QgsFeature)

setOpenFormButtonVisible(self, openFormButtonVisible: bool)

Parameters:

openFormButtonVisible (bool)

setOrderExpression(self, orderExpression: str | None)

Set the string of the order expression The order expression will be used for sort values in the combobox.

Added in version 4.0.

Parameters:

orderExpression (Optional[str])

setParentFormFeature(self, parentFormFeature: QgsFeature)

Set the current parent form feature

Added in version 3.42.2.

Parameters:

parentFormFeature (QgsFeature)

setReadOnlySelector(self, readOnly: bool)

Parameters:

readOnly (bool)

setReferencedLayerDataSource(self, referencedLayerDataSource: str | None)

Set the public data source of the referenced layer to referencedLayerDataSource

Added in version 3.12.

Parameters:

referencedLayerDataSource (Optional[str])

setReferencedLayerId(self, referencedLayerId: str | None)

Set the id of the referenced layer to referencedLayerId

Added in version 3.12.

Parameters:

referencedLayerId (Optional[str])

setReferencedLayerName(self, referencedLayerName: str | None)

Set the name of the referenced layer to referencedLayerName

Added in version 3.12.

Parameters:

referencedLayerName (Optional[str])

setReferencedLayerProviderKey(self, referencedLayerProviderKey: str | None)

Set the data provider key of the referenced layer to referencedLayerProviderKey

Added in version 3.12.

Parameters:

referencedLayerProviderKey (Optional[str])

setRelation(self, relation: QgsRelation, allowNullValue: bool)

Parameters:

• relation (QgsRelation)

• allowNullValue (bool)

setRelationEditable(self, editable: bool)

Parameters:

editable (bool)

setSortOrder(self, sortOrder: Qt.SortOrder)

Set the order direction The order direction will be used for sort values in the combobox. Ascending or descending

Added in version 4.0.

Parameters:

sortOrder (Qt.SortOrder)

showIndeterminateState(self)

Sets the widget to display in an indeterminate “mixed value” state.

sortOrder(self) → Qt.SortOrder

Returns the order direction The order direction will be used for sort values in the combobox. Ascending or descending

Added in version 4.0.

Return type:

Qt.SortOrder