Class: QgsAttributeEditorContainer

A container for attribute editors, used to group them visually in the attribute form if it is set to the drag and drop designer.

Class Hierarchy

Base classes

QgsAttributeEditorElement

An abstract base class for any elements of a drag and drop form.

Abstract Methods

clone

Creates a deep copy of this element.

Methods

backgroundColor	Returns the background color of the container.
children	Gets a list of the children elements of this container
clear	Clear all children from this container.
collapsed	For group box containers returns True if this group box is collapsed.
columnCount	Gets the number of columns in this group.
setBackgroundColor	Sets the background color to backgroundColor.
setCollapsed	For group box containers sets if this group box is collapsed.
setColumnCount	Set the number of columns in this group.
setName	Change the name of this container.
setType	Sets the container type.
setVisibilityExpression	The visibility expression is used in the attribute form to show or hide this container based on an expression incorporating the field value controlled by editor widgets.
type	Returns the container type.
visibilityExpression	The visibility expression is used in the attribute form to show or hide this container based on an expression incorporating the field value controlled by editor widgets.

Virtual Methods

In PyQGIS, only methods marked as virtual can be safely overridden in a Python subclass of QgsAttributeEditorContainer. See the FAQ for more details.

addChildElement	Add a child element to this container.
findElements	Traverses the element tree to find any element of the specified type
isGroupBox	Returns if this container is going to be a group box
setIsGroupBox	Determines if this container is rendered as collapsible group box or tab in a tabwidget

class qgis.core.QgsAttributeEditorContainer

Bases: QgsAttributeEditorElement

__init__(name: str | None, parent: QgsAttributeEditorElement | None, backgroundColor: QColor | Qt.GlobalColor = QColor())

Creates a new attribute editor container

Parameters:

• name (Optional[str]) – The name to show as title

• parent (Optional[QgsAttributeEditorElement]) – The parent. May be another container.

• backgroundColor (Union[QColor, Qt.GlobalColor] = QColor()) – The optional background color of the container.

__init__(a0: QgsAttributeEditorContainer)

Parameters:

a0 (QgsAttributeEditorContainer)

virtual addChildElement(self, element: QgsAttributeEditorElement | None)

Add a child element to this container. This may be another container, a field or a relation.

Parameters:

element (Optional[QgsAttributeEditorElement]) – The element to add as child

backgroundColor(self) → QColor

Returns the background color of the container.

See also

setBackgroundColor()

Added in version 3.8.

Return type:

QColor

children(self) → List[QgsAttributeEditorElement]

Gets a list of the children elements of this container

Return type:

List[QgsAttributeEditorElement]

Returns:

A list of elements

clear(self)

Clear all children from this container.

abstract clone(self, parent: QgsAttributeEditorElement | None) → QgsAttributeEditorElement | None

Creates a deep copy of this element. To be implemented by subclasses.

Parameters:

parent (Optional[QgsAttributeEditorElement])

Return type:

Optional[QgsAttributeEditorElement]

collapsed(self) → bool

For group box containers returns True if this group box is collapsed.

Return type:

bool

Returns:

True if the group box is collapsed, False otherwise.

See also

collapsed()

See also

setCollapsed()

Added in version 3.26.

columnCount(self) → int

Gets the number of columns in this group.

See also

setColumnCount()

Return type:

int

virtual findElements(self, type: Qgis.AttributeEditorType) → List[QgsAttributeEditorElement]

Traverses the element tree to find any element of the specified type

Parameters:

type (Qgis.AttributeEditorType) – The type which should be searched

Return type:

List[QgsAttributeEditorElement]

Returns:

A list of elements of the type which has been searched for

virtual isGroupBox(self) → bool

Returns if this container is going to be a group box

Return type:

bool

Returns:

True if it will be a group box, False if it will be a tab

Deprecated since version 3.40: Use type() instead.

setBackgroundColor(self, backgroundColor: QColor | Qt.GlobalColor)

Sets the background color to backgroundColor.

See also

backgroundColor()

Parameters:

backgroundColor (Union[QColor, Qt.GlobalColor])

setCollapsed(self, collapsed: bool)

For group box containers sets if this group box is collapsed.

See also

collapsed()

See also

setCollapsed()

Added in version 3.26.

Parameters:

collapsed (bool)

setColumnCount(self, columnCount: int)

Set the number of columns in this group.

See also

columnCount()

Parameters:

columnCount (int)

virtual setIsGroupBox(self, isGroupBox: bool)

Determines if this container is rendered as collapsible group box or tab in a tabwidget

Parameters:

isGroupBox (bool) – If True, this will be a group box

Deprecated since version 3.40: Use setType() instead.

setName(self, name: str | None)

Change the name of this container.

Parameters:

name (Optional[str])

setType(self, type: Qgis.AttributeEditorContainerType)

Sets the container type.

See also

type()

Added in version 3.32.

Parameters:

type (Qgis.AttributeEditorContainerType)

setVisibilityExpression(self, visibilityExpression: QgsOptionalExpression)

The visibility expression is used in the attribute form to show or hide this container based on an expression incorporating the field value controlled by editor widgets.

Parameters:

visibilityExpression (QgsOptionalExpression)

type(self) → Qgis.AttributeEditorContainerType

Returns the container type.

See also

setType()

Added in version 3.32.

Return type:

Qgis.AttributeEditorContainerType

visibilityExpression(self) → QgsOptionalExpression

The visibility expression is used in the attribute form to show or hide this container based on an expression incorporating the field value controlled by editor widgets.

Return type:

QgsOptionalExpression