QGIS API Documentation  3.8.0-Zanzibar (11aff65)
Public Member Functions | List of all members
QgsAttributeEditorContainer Class Reference

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

#include <qgsattributeeditorelement.h>

Inheritance diagram for QgsAttributeEditorContainer:
Inheritance graph
[legend]

Public Member Functions

 QgsAttributeEditorContainer (const QString &name, QgsAttributeEditorElement *parent, const QColor &backgroundColor=QColor())
 Creates a new attribute editor container. More...
 
 ~QgsAttributeEditorContainer () override
 
virtual void addChildElement (QgsAttributeEditorElement *element)
 Add a child element to this container. More...
 
QColor backgroundColor () const
 backgroundColor More...
 
QList< QgsAttributeEditorElement * > children () const
 Gets a list of the children elements of this container. More...
 
void clear ()
 Clear all children from this container. More...
 
QgsAttributeEditorElementclone (QgsAttributeEditorElement *parent) const override
 Creates a deep copy of this element. More...
 
int columnCount () const
 Gets the number of columns in this group. More...
 
virtual QList< QgsAttributeEditorElement * > findElements (AttributeEditorType type) const
 Traverses the element tree to find any element of the specified type. More...
 
virtual bool isGroupBox () const
 Returns if this container is going to be rendered as a group box. More...
 
void setBackgroundColor (const QColor &backgroundColor)
 Sets the background color to backgroundColor. More...
 
void setColumnCount (int columnCount)
 Set the number of columns in this group. More...
 
virtual void setIsGroupBox (bool isGroupBox)
 Determines if this container is rendered as collapsible group box or tab in a tabwidget. More...
 
void setName (const QString &name)
 Change the name of this container. More...
 
void setVisibilityExpression (const QgsOptionalExpression &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. More...
 
QgsOptionalExpression visibilityExpression () const
 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. More...
 
- Public Member Functions inherited from QgsAttributeEditorElement
 QgsAttributeEditorElement (AttributeEditorType type, const QString &name, QgsAttributeEditorElement *parent=nullptr)
 Constructor. More...
 
virtual ~QgsAttributeEditorElement ()=default
 
QString name () const
 Returns the name of this element. More...
 
QgsAttributeEditorElementparent () const
 Gets the parent of this element. More...
 
void setShowLabel (bool showLabel)
 Controls if this element should be labeled with a title (field, relation or groupname). More...
 
bool showLabel () const
 Controls if this element should be labeled with a title (field, relation or groupname). More...
 
QDomElement toDomElement (QDomDocument &doc) const
 Gets the XML Dom element to save this element. More...
 
AttributeEditorType type () const
 The type of this element. More...
 

Additional Inherited Members

- Public Types inherited from QgsAttributeEditorElement
enum  AttributeEditorType {
  AeTypeContainer, AeTypeField, AeTypeRelation, AeTypeInvalid,
  AeTypeQmlElement, AeTypeHtmlElement
}
 
- Protected Attributes inherited from QgsAttributeEditorElement
QString mName
 
QgsAttributeEditorElementmParent = nullptr
 
bool mShowLabel
 
AttributeEditorType mType
 

Detailed Description

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

Definition at line 169 of file qgsattributeeditorelement.h.

Constructor & Destructor Documentation

◆ QgsAttributeEditorContainer()

QgsAttributeEditorContainer::QgsAttributeEditorContainer ( const QString &  name,
QgsAttributeEditorElement parent,
const QColor &  backgroundColor = QColor() 
)
inline

Creates a new attribute editor container.

Parameters
nameThe name to show as title
parentThe parent. May be another container.
backgroundColorThe optional background color of the container.

Definition at line 180 of file qgsattributeeditorelement.h.

◆ ~QgsAttributeEditorContainer()

QgsAttributeEditorContainer::~QgsAttributeEditorContainer ( )
override

Definition at line 28 of file qgseditformconfig.cpp.

Member Function Documentation

◆ addChildElement()

void QgsAttributeEditorContainer::addChildElement ( QgsAttributeEditorElement element)
virtual

Add a child element to this container.

This may be another container, a field or a relation.

Parameters
elementThe element to add as child

Definition at line 19 of file qgsattributeeditorelement.cpp.

◆ backgroundColor()

QColor QgsAttributeEditorContainer::backgroundColor ( ) const

backgroundColor

Returns
background color of the container
Since
QGIS 3.8

Definition at line 42 of file qgsattributeeditorelement.cpp.

◆ children()

QList<QgsAttributeEditorElement *> QgsAttributeEditorContainer::children ( ) const
inline

Gets a list of the children elements of this container.

Returns
A list of elements

Definition at line 216 of file qgsattributeeditorelement.h.

◆ clear()

void QgsAttributeEditorContainer::clear ( )

Clear all children from this container.

Definition at line 75 of file qgsattributeeditorelement.cpp.

◆ clone()

QgsAttributeEditorElement * QgsAttributeEditorContainer::clone ( QgsAttributeEditorElement parent) const
overridevirtual

Creates a deep copy of this element.

To be implemented by subclasses.

Since
QGIS 3.0

Implements QgsAttributeEditorElement.

Definition at line 613 of file qgseditformconfig.cpp.

◆ columnCount()

int QgsAttributeEditorContainer::columnCount ( ) const

Gets the number of columns in this group.

Definition at line 603 of file qgseditformconfig.cpp.

◆ findElements()

QList< QgsAttributeEditorElement * > QgsAttributeEditorContainer::findElements ( QgsAttributeEditorElement::AttributeEditorType  type) const
virtual

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

Parameters
typeThe type which should be searched
Returns
A list of elements of the type which has been searched for

Definition at line 52 of file qgsattributeeditorelement.cpp.

◆ isGroupBox()

virtual bool QgsAttributeEditorContainer::isGroupBox ( ) const
inlinevirtual

Returns if this container is going to be rendered as a group box.

Returns
true if it will be a group box, false if it will be a tab

Definition at line 209 of file qgsattributeeditorelement.h.

◆ setBackgroundColor()

void QgsAttributeEditorContainer::setBackgroundColor ( const QColor &  backgroundColor)

Sets the background color to backgroundColor.

Definition at line 47 of file qgsattributeeditorelement.cpp.

◆ setColumnCount()

void QgsAttributeEditorContainer::setColumnCount ( int  columnCount)

Set the number of columns in this group.

Definition at line 608 of file qgseditformconfig.cpp.

◆ setIsGroupBox()

virtual void QgsAttributeEditorContainer::setIsGroupBox ( bool  isGroupBox)
inlinevirtual

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

Parameters
isGroupBoxIf true, this will be a group box

Definition at line 202 of file qgsattributeeditorelement.h.

◆ setName()

void QgsAttributeEditorContainer::setName ( const QString &  name)

Change the name of this container.

Definition at line 24 of file qgsattributeeditorelement.cpp.

◆ setVisibilityExpression()

void QgsAttributeEditorContainer::setVisibilityExpression ( const QgsOptionalExpression 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.

Since
QGIS 3.0

Definition at line 34 of file qgsattributeeditorelement.cpp.

◆ visibilityExpression()

QgsOptionalExpression QgsAttributeEditorContainer::visibilityExpression ( ) const

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.

Since
QGIS 3.0

Definition at line 29 of file qgsattributeeditorelement.cpp.


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