QGIS API Documentation 3.28.0-Firenze (ed3ad0430f)
qgslabelsettingswidgetbase.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgslabelsettingswidgetbase.h
3 ----------------------
4 begin : December 2019
5 copyright : (C) 2019 by Nyall Dawson
6 email : nyall dot dawson at gmail dot com
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
16
22#include "qgsauxiliarystorage.h"
23#include "qgsgui.h"
24
25
27 : QgsPanelWidget( parent )
28 , mVectorLayer( vl )
29{
30}
31
33{
34 mContext = context;
35}
36
38{
39 return mContext;
40}
41
43{
44
45}
46
48{
49 if ( auto *lExpressionContext = mContext.expressionContext() )
50 return *lExpressionContext;
51
52 QgsExpressionContext expContext( mContext.globalProjectAtlasMapLayerScopes( mVectorLayer ) );
55 expContext << symbolScope;
56
57 // additional scopes
58 const auto constAdditionalExpressionContextScopes = mContext.additionalExpressionContextScopes();
59 for ( const QgsExpressionContextScope &scope : constAdditionalExpressionContextScopes )
60 {
61 expContext.appendScope( new QgsExpressionContextScope( scope ) );
62 }
63
64 //TODO - show actual value
65 expContext.setOriginalValueVariable( QVariant() );
66
68
69 return expContext;
70}
71
72void QgsLabelSettingsWidgetBase::createAuxiliaryField()
73{
74 // try to create an auxiliary layer if not yet created
75 if ( !mVectorLayer->auxiliaryLayer() )
76 {
77 QgsNewAuxiliaryLayerDialog dlg( mVectorLayer, this );
78 dlg.exec();
79 }
80
81 // return if still not exists
82 if ( !mVectorLayer->auxiliaryLayer() )
83 return;
84
85 QgsPropertyOverrideButton *button = qobject_cast<QgsPropertyOverrideButton *>( sender() );
86 const QgsPalLayerSettings::Property key = static_cast< QgsPalLayerSettings::Property >( button->propertyKey() );
88
89 // create property in auxiliary storage if necessary
90 if ( !mVectorLayer->auxiliaryLayer()->exists( def ) )
91 {
92 QgsNewAuxiliaryFieldDialog dlg( def, mVectorLayer, true, this );
93 if ( dlg.exec() == QDialog::Accepted )
94 def = dlg.propertyDefinition();
95 }
96
97 // return if still not exist
98 if ( !mVectorLayer->auxiliaryLayer()->exists( def ) )
99 return;
100
101 // update property with join field name from auxiliary storage
102 QgsProperty property = button->toProperty();
103 property.setField( QgsAuxiliaryLayer::nameFromProperty( def, true ) );
104 property.setActive( true );
105 button->updateFieldLists();
106 button->setToProperty( property );
107
109
111
112 emit changed();
113}
114
115void QgsLabelSettingsWidgetBase::updateDataDefinedProperty()
116{
117 QgsPropertyOverrideButton *button = qobject_cast<QgsPropertyOverrideButton *>( sender() );
118 const QgsPalLayerSettings::Property key = static_cast< QgsPalLayerSettings::Property >( button->propertyKey() );
120 emit changed();
121}
122
124{
126}
127
129{
131
132 const auto overrideButtons = findChildren<QgsPropertyOverrideButton *>();
133 for ( QgsPropertyOverrideButton *button : overrideButtons )
134 {
135 const QgsPalLayerSettings::Property key = static_cast< QgsPalLayerSettings::Property >( button->propertyKey() );
137 }
138}
139
141{
142
143}
144
146{
147 button->init( key, mDataDefinedProperties, QgsPalLayerSettings::propertyDefinitions(), mVectorLayer, true );
148 connect( button, &QgsPropertyOverrideButton::changed, this, &QgsLabelSettingsWidgetBase::updateDataDefinedProperty );
149 connect( button, &QgsPropertyOverrideButton::createAuxiliaryField, this, &QgsLabelSettingsWidgetBase::createAuxiliaryField );
150
152}
153
154
155//
156// QgsLabelSettingsWidgetDialog
157//
158
160 : QDialog( parent )
161{
162 setWindowTitle( widget->windowTitle() );
163 QVBoxLayout *vLayout = new QVBoxLayout();
164 vLayout->addWidget( widget );
165 mButtonBox = new QDialogButtonBox( QDialogButtonBox::Ok | QDialogButtonBox::Cancel, Qt::Horizontal );
166 connect( mButtonBox, &QDialogButtonBox::accepted, this, &QDialog::accept );
167 connect( mButtonBox, &QDialogButtonBox::rejected, this, &QDialog::reject );
168 vLayout->addWidget( mButtonBox );
169 setLayout( vLayout );
170
171 setObjectName( QStringLiteral( "QgsLabelSettingsWidgetDialog" ) );
173}
174
176{
177 return mButtonBox;
178}
static QString nameFromProperty(const QgsPropertyDefinition &def, bool joined=false)
Returns the name of the auxiliary field for a property definition.
bool exists(const QgsPropertyDefinition &definition) const
Returns true if the property is stored in the layer already, false otherwise.
Single scope for storing variables and functions for use within a QgsExpressionContext.
void addVariable(const QgsExpressionContextScope::StaticVariable &variable)
Adds a variable into the context scope.
static QgsExpressionContextScope * updateSymbolScope(const QgsSymbol *symbol, QgsExpressionContextScope *symbolScope=nullptr)
Updates a symbol scope related to a QgsSymbol to an expression context.
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
void setOriginalValueVariable(const QVariant &value)
Sets the original value variable value for the context.
static const QString EXPR_SYMBOL_COLOR
Inbuilt variable name for symbol color variable.
void appendScope(QgsExpressionContextScope *scope)
Appends a scope to the end of the context.
void setHighlightedVariables(const QStringList &variableNames)
Sets the list of variable names within the context intended to be highlighted to the user.
static const QString EXPR_ORIGINAL_VALUE
Inbuilt variable name for value original value variable.
static void enableAutoGeometryRestore(QWidget *widget, const QString &key=QString())
Register the widget to allow its position to be automatically saved and restored when open and closed...
Definition: qgsgui.cpp:178
Base class for widgets which allow customization of label engine properties, such as label placement ...
virtual void updateDataDefinedProperties(QgsPropertyCollection &properties)
Updates a data defined properties collection, correctly setting the values for any properties related...
void changed()
Emitted when any of the settings described by the widget are changed.
QgsSymbolWidgetContext context() const
Returns the context in which the symbol widget is shown, e.g., the associated map canvas and expressi...
void registerDataDefinedButton(QgsPropertyOverrideButton *button, QgsPalLayerSettings::Property key)
Registers a data defined override button.
QgsLabelSettingsWidgetBase(QWidget *parent=nullptr, QgsVectorLayer *vl=nullptr)
Constructor for QgsLabelSettingsWidgetBase.
virtual void setContext(const QgsSymbolWidgetContext &context)
Sets the context in which the symbol widget is shown, e.g., the associated map canvas and expression ...
QgsPropertyCollection mDataDefinedProperties
Contains the data defined properties defined by the widget.
void auxiliaryFieldCreated()
Emitted when an auxiliary field is created in the widget.
void setDataDefinedProperties(const QgsPropertyCollection &dataDefinedProperties)
Sets the current data defined properties to show in the widget.
virtual void setGeometryType(QgsWkbTypes::GeometryType type)
Sets the geometry type of the features to customize the widget accordingly.
QgsPropertyCollection dataDefinedProperties() const
Returns the current data defined properties state as specified in the widget.
QgsExpressionContext createExpressionContext() const override
This method needs to be reimplemented in all classes which implement this interface and return an exp...
QgsLabelSettingsWidgetDialog(QgsLabelSettingsWidgetBase *widget, QWidget *parent=nullptr)
Constructor for QgsLabelSettingsWidgetDialog.
QDialogButtonBox * buttonBox()
Returns the dialog's button box.
A dialog to create a new auxiliary field.
A dialog to create a new auxiliary layer.
Property
Data definable properties.
static const QgsPropertiesDefinition & propertyDefinitions()
Returns the labeling property definitions.
Base class for any widget that can be shown as a inline panel.
A grouped map of multiple QgsProperty objects, each referenced by a integer key value.
QgsProperty property(int key) const override
Returns a matching property from the collection, if one exists.
void setProperty(int key, const QgsProperty &property)
Adds a property to the collection and takes ownership of it.
Definition for a property.
Definition: qgsproperty.h:46
A button for controlling property overrides which may apply to a widget.
QgsProperty toProperty() const
Returns a QgsProperty object encapsulating the current state of the widget.
void updateFieldLists()
Updates list of fields.
void changed()
Emitted when property definition changes.
void init(int propertyKey, const QgsProperty &property, const QgsPropertiesDefinition &definitions, const QgsVectorLayer *layer=nullptr, bool auxiliaryStorageEnabled=false)
Initialize a newly constructed property button (useful if button was included in a UI layout).
void registerExpressionContextGenerator(QgsExpressionContextGenerator *generator)
Register an expression context generator class that will be used to retrieve an expression context fo...
int propertyKey() const
Returns the property key linked to the button.
void setToProperty(const QgsProperty &property)
Sets the widget to reflect the current state of a QgsProperty.
void createAuxiliaryField()
Emitted when creating a new auxiliary field.
A store for object properties.
Definition: qgsproperty.h:230
void setField(const QString &field)
Sets the field name the property references.
Contains settings which reflect the context in which a symbol (or renderer) widget is shown,...
QList< QgsExpressionContextScope > additionalExpressionContextScopes() const
Returns the list of additional expression context scopes to show as available within the layer.
QList< QgsExpressionContextScope * > globalProjectAtlasMapLayerScopes(const QgsMapLayer *layer) const
Returns list of scopes: global, project, atlas, map, layer.
QgsExpressionContext * expressionContext() const
Returns the expression context used for the widget, if set.
Represents a vector layer which manages a vector based data sets.
QgsAuxiliaryLayer * auxiliaryLayer()
Returns the current auxiliary layer.
GeometryType
The geometry types are used to group QgsWkbTypes::Type in a coarse way.
Definition: qgswkbtypes.h:141
Single variable definition for use within a QgsExpressionContextScope.