QGIS API Documentation  3.22.4-Białowieża (ce8e65e95e)
qgsattributeeditorrelation.cpp
Go to the documentation of this file.
1 /***************************************************************************
2  qgsattributeeditorrelation.cpp - QgsAttributeEditorRelation
3 
4  ---------------------
5  begin : 12.01.2021
6  copyright : (C) 2021 by Denis Rouzaud
7  email : [email protected]
8  ***************************************************************************
9  * *
10  * This program is free software; you can redistribute it and/or modify *
11  * it under the terms of the GNU General Public License as published by *
12  * the Free Software Foundation; either version 2 of the License, or *
13  * (at your option) any later version. *
14  * *
15  ***************************************************************************/
17 #include "qgsrelationmanager.h"
18 #include "qgsxmlutils.h"
19 
21 {
22  mRelation = relationManager->relation( mRelationId );
23  return mRelation.isValid();
24 }
25 
27 {
28  QgsAttributeEditorRelation *element = new QgsAttributeEditorRelation( mRelationId, parent );
29  element->mRelation = mRelation;
30  element->mButtons = mButtons;
31  element->mForceSuppressFormPopup = mForceSuppressFormPopup;
32  element->mNmRelationId = mNmRelationId;
33  element->mLabel = mLabel;
34  element->mRelationEditorConfig = mRelationEditorConfig;
35 
36  return element;
37 }
38 
39 void QgsAttributeEditorRelation::saveConfiguration( QDomElement &elem, QDomDocument &doc ) const
40 {
41  elem.setAttribute( QStringLiteral( "relation" ), mRelation.id() );
42  elem.setAttribute( QStringLiteral( "forceSuppressFormPopup" ), mForceSuppressFormPopup );
43  elem.setAttribute( QStringLiteral( "nmRelationId" ), mNmRelationId.toString() );
44  elem.setAttribute( QStringLiteral( "label" ), mLabel );
45  elem.setAttribute( QStringLiteral( "relationWidgetTypeId" ), mRelationWidgetTypeId );
46 
47  QDomElement elemConfig = QgsXmlUtils::writeVariant( mRelationEditorConfig, doc );
48  elemConfig.setTagName( QStringLiteral( "editor_configuration" ) );
49  elem.appendChild( elemConfig );
50 }
51 
52 void QgsAttributeEditorRelation::loadConfiguration( const QDomElement &element, const QString &layerId, const QgsReadWriteContext &context, const QgsFields &fields )
53 {
54  Q_UNUSED( layerId )
55  Q_UNUSED( context )
56  Q_UNUSED( fields )
57 
58  QVariantMap config = QgsXmlUtils::readVariant( element.firstChildElement( "editor_configuration" ) ).toMap();
59 
60  // load defaults
61  if ( config.isEmpty() )
62  config = relationEditorConfiguration();
63 
64  // pre QGIS 3.18 compatibility
65  if ( ! config.contains( QStringLiteral( "buttons" ) ) )
66  {
67  if ( element.hasAttribute( "buttons" ) )
68  {
70  // QgsAttributeEditorRelation::Button has been deprecated in favor of QgsRelationEditorWidget::Button
71  // we cannot use it here since the new flags are in gui, while the current code is in core
72  // TODO: remove this compatibility code in QGIS 4
73  // or make the enum private if we really want to keep the backward compatibility (but not worth it!)
74  const QString buttonString = element.attribute( QStringLiteral( "buttons" ), qgsFlagValueToKeys( QgsAttributeEditorRelation::Button::AllButtons ) );
75  config.insert( "buttons", qgsFlagValueToKeys( qgsFlagKeysToValue( buttonString, QgsAttributeEditorRelation::Button::AllButtons ) ) );
77  }
78  else
79  {
80  // pre QGIS 3.16 compatibility
82  QgsAttributeEditorRelation::Buttons buttons = QgsAttributeEditorRelation::Button::AllButtons;
83  buttons.setFlag( QgsAttributeEditorRelation::Button::Link, element.attribute( QStringLiteral( "showLinkButton" ), QStringLiteral( "1" ) ).toInt() );
84  buttons.setFlag( QgsAttributeEditorRelation::Button::Unlink, element.attribute( QStringLiteral( "showUnlinkButton" ), QStringLiteral( "1" ) ).toInt() );
85  buttons.setFlag( QgsAttributeEditorRelation::Button::SaveChildEdits, element.attribute( QStringLiteral( "showSaveChildEditsButton" ), QStringLiteral( "1" ) ).toInt() );
87  config.insert( "buttons", qgsFlagValueToKeys( buttons ) );
88  }
89  }
90 
92 
93  setForceSuppressFormPopup( element.attribute( QStringLiteral( "forceSuppressFormPopup" ), 0 ).toInt() );
94 
95  if ( element.hasAttribute( QStringLiteral( "nmRelationId" ) ) )
96  {
97  setNmRelationId( element.attribute( QStringLiteral( "nmRelationId" ) ) );
98  }
99 
100  if ( element.hasAttribute( "label" ) )
101  {
102  const QString label = element.attribute( QStringLiteral( "label" ) );
103  setLabel( label );
104  }
105  if ( element.hasAttribute( "relationWidgetTypeId" ) )
106  {
107  const QString relationWidgetTypeId = element.attribute( QStringLiteral( "relationWidgetTypeId" ) );
109  }
110 }
111 
112 QString QgsAttributeEditorRelation::typeIdentifier() const
113 {
114  return QStringLiteral( "attributeEditorRelation" );
115 }
116 
117 void QgsAttributeEditorRelation::setForceSuppressFormPopup( bool forceSuppressFormPopup )
118 {
119  mForceSuppressFormPopup = forceSuppressFormPopup;
120 }
121 
123 {
124  return mForceSuppressFormPopup;
125 }
126 
127 void QgsAttributeEditorRelation::setNmRelationId( const QVariant &nmRelationId )
128 {
129  mNmRelationId = nmRelationId;
130 }
131 
133 {
134  return mNmRelationId;
135 }
136 
137 void QgsAttributeEditorRelation::setLabel( const QString &label )
138 {
139  mLabel = label;
140 }
141 
143 {
144  return mLabel;
145 }
146 
148 {
149  return mRelationWidgetTypeId;
150 }
151 
152 void QgsAttributeEditorRelation::setRelationWidgetTypeId( const QString &relationWidgetTypeId )
153 {
154  mRelationWidgetTypeId = relationWidgetTypeId;
155 }
156 
158 {
159  return mRelationEditorConfig;
160 }
161 
163 {
164  mRelationEditorConfig = config;
165 }
This is an abstract base class for any elements of a drag and drop form.
QgsAttributeEditorElement * parent() const
Gets the parent of this element.
This element will load a relation editor onto the form.
void setNmRelationId(const QVariant &nmRelationId=QVariant())
Sets nmRelationId for the relation id of the second relation involved in an N:M relation.
bool init(QgsRelationManager *relManager)
Initializes the relation from the id.
void setRelationWidgetTypeId(const QString &relationWidgetTypeId)
Sets the relation widget type.
QgsAttributeEditorElement * clone(QgsAttributeEditorElement *parent) const override
Returns a clone of this element.
QVariantMap relationEditorConfiguration() const
Returns the relation editor widget configuration.
void setForceSuppressFormPopup(bool forceSuppressFormPopup)
Sets force suppress form popup status to forceSuppressFormPopup.
QVariant nmRelationId() const
Determines the relation id of the second relation involved in an N:M relation.
bool forceSuppressFormPopup() const
Determines the force suppress form popup status.
Q_DECL_DEPRECATED QgsAttributeEditorRelation(const QString &name, const QString &relationId, QgsAttributeEditorElement *parent)
QString relationWidgetTypeId() const
Returns the current relation widget type id.
void setRelationEditorConfiguration(const QVariantMap &config)
Sets the relation editor configuration.
void setLabel(const QString &label=QString())
Sets label for this element If it's empty it takes the relation id as label.
QString label() const
Determines the label of this element.
Container of fields for a vector layer.
Definition: qgsfields.h:45
The class is used as a container of context for various read/write operations on other objects.
This class manages a set of relations between layers.
Q_INVOKABLE QgsRelation relation(const QString &id) const
Gets access to a relation by its id.
Q_GADGET QString id
Definition: qgsrelation.h:46
bool isValid
Definition: qgsrelation.h:50
static QDomElement writeVariant(const QVariant &value, QDomDocument &doc)
Write a QVariant to a QDomElement.
static QVariant readVariant(const QDomElement &element)
Read a QVariant from a QDomElement.
#define Q_NOWARN_DEPRECATED_POP
Definition: qgis.h:1742
#define Q_NOWARN_DEPRECATED_PUSH
Definition: qgis.h:1741
T qgsFlagKeysToValue(const QString &keys, const T &defaultValue)
Returns the value corresponding to the given keys of a flag.
Definition: qgis.h:1460
QString qgsFlagValueToKeys(const T &value)
Returns the value for the given keys of a flag.
Definition: qgis.h:1448