QGIS API Documentation  3.0.2-Girona (307d082)
qgstextformatwidget.cpp
Go to the documentation of this file.
1 /***************************************************************************
2  qgstextformatwidget.h
3  ---------------------
4  begin : June 2009
5  copyright : (C) Martin Dobias
6  email : wonder dot sk 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 #include "qgstextformatwidget.h"
17 #include "qgsmapcanvas.h"
18 #include "qgscharacterselectordialog.h"
19 #include "qgslogger.h"
20 #include "qgsfontutils.h"
21 #include "qgssymbollayerutils.h"
22 #include "qgssvgcache.h"
23 #include "qgssvgselectorwidget.h"
24 #include "qgssubstitutionlistwidget.h"
25 #include "qgspallabeling.h" // for enum values
26 #include "qgspathresolver.h"
27 #include "qgsproject.h"
28 #include "qgssettings.h"
29 #include "qgseffectstack.h"
30 #include "qgspainteffectregistry.h"
31 
32 #include <QButtonGroup>
33 
34 QgsTextFormatWidget::QgsTextFormatWidget( const QgsTextFormat &format, QgsMapCanvas *mapCanvas, QWidget *parent )
35  : QWidget( parent )
36  , mMapCanvas( mapCanvas )
37 {
38  initWidget();
39  setWidgetMode( Text );
40  updateWidgetForFormat( format );
41 }
42 
43 QgsTextFormatWidget::QgsTextFormatWidget( QgsMapCanvas *mapCanvas, QWidget *parent, Mode mode )
44  : QWidget( parent )
45  , mWidgetMode( mode )
46  , mMapCanvas( mapCanvas )
47 {
48  initWidget();
49  setWidgetMode( mode );
50 }
51 
52 void QgsTextFormatWidget::initWidget()
53 {
54  setupUi( this );
55  connect( mShapeSVGPathLineEdit, &QLineEdit::textChanged, this, &QgsTextFormatWidget::mShapeSVGPathLineEdit_textChanged );
56  connect( mFontSizeSpinBox, static_cast < void ( QDoubleSpinBox::* )( double ) > ( &QDoubleSpinBox::valueChanged ), this, &QgsTextFormatWidget::mFontSizeSpinBox_valueChanged );
57  connect( mFontCapitalsComboBox, static_cast<void ( QComboBox::* )( int )>( &QComboBox::currentIndexChanged ), this, &QgsTextFormatWidget::mFontCapitalsComboBox_currentIndexChanged );
58  connect( mFontFamilyCmbBx, &QFontComboBox::currentFontChanged, this, &QgsTextFormatWidget::mFontFamilyCmbBx_currentFontChanged );
59  connect( mFontStyleComboBox, static_cast<void ( QComboBox::* )( const QString & )>( &QComboBox::currentIndexChanged ), this, &QgsTextFormatWidget::mFontStyleComboBox_currentIndexChanged );
60  connect( mFontUnderlineBtn, &QToolButton::toggled, this, &QgsTextFormatWidget::mFontUnderlineBtn_toggled );
61  connect( mFontStrikethroughBtn, &QToolButton::toggled, this, &QgsTextFormatWidget::mFontStrikethroughBtn_toggled );
62  connect( mFontWordSpacingSpinBox, static_cast < void ( QDoubleSpinBox::* )( double ) > ( &QDoubleSpinBox::valueChanged ), this, &QgsTextFormatWidget::mFontWordSpacingSpinBox_valueChanged );
63  connect( mFontLetterSpacingSpinBox, static_cast < void ( QDoubleSpinBox::* )( double ) > ( &QDoubleSpinBox::valueChanged ), this, &QgsTextFormatWidget::mFontLetterSpacingSpinBox_valueChanged );
64  connect( mFontSizeUnitWidget, &QgsUnitSelectionWidget::changed, this, &QgsTextFormatWidget::mFontSizeUnitWidget_changed );
65  connect( mFontMinPixelSpinBox, static_cast < void ( QSpinBox::* )( int ) > ( &QSpinBox::valueChanged ), this, &QgsTextFormatWidget::mFontMinPixelSpinBox_valueChanged );
66  connect( mFontMaxPixelSpinBox, static_cast < void ( QSpinBox::* )( int ) > ( &QSpinBox::valueChanged ), this, &QgsTextFormatWidget::mFontMaxPixelSpinBox_valueChanged );
67  connect( mBufferUnitWidget, &QgsUnitSelectionWidget::changed, this, &QgsTextFormatWidget::mBufferUnitWidget_changed );
68  connect( mCoordXDDBtn, &QgsPropertyOverrideButton::activated, this, &QgsTextFormatWidget::mCoordXDDBtn_activated );
69  connect( mCoordYDDBtn, &QgsPropertyOverrideButton::activated, this, &QgsTextFormatWidget::mCoordYDDBtn_activated );
70  connect( mShapeTypeCmbBx, static_cast<void ( QComboBox::* )( int )>( &QComboBox::currentIndexChanged ), this, &QgsTextFormatWidget::mShapeTypeCmbBx_currentIndexChanged );
71  connect( mShapeRotationCmbBx, static_cast<void ( QComboBox::* )( int )>( &QComboBox::currentIndexChanged ), this, &QgsTextFormatWidget::mShapeRotationCmbBx_currentIndexChanged );
72  connect( mShapeSVGParamsBtn, &QPushButton::clicked, this, &QgsTextFormatWidget::mShapeSVGParamsBtn_clicked );
73  connect( mShapeSVGSelectorBtn, &QPushButton::clicked, this, &QgsTextFormatWidget::mShapeSVGSelectorBtn_clicked );
74  connect( mPreviewTextEdit, &QLineEdit::textChanged, this, &QgsTextFormatWidget::mPreviewTextEdit_textChanged );
75  connect( mPreviewTextBtn, &QToolButton::clicked, this, &QgsTextFormatWidget::mPreviewTextBtn_clicked );
76  connect( mPreviewBackgroundBtn, &QgsColorButton::colorChanged, this, &QgsTextFormatWidget::mPreviewBackgroundBtn_colorChanged );
77  connect( mDirectSymbLeftToolBtn, &QToolButton::clicked, this, &QgsTextFormatWidget::mDirectSymbLeftToolBtn_clicked );
78  connect( mDirectSymbRightToolBtn, &QToolButton::clicked, this, &QgsTextFormatWidget::mDirectSymbRightToolBtn_clicked );
79  connect( mChkNoObstacle, &QCheckBox::toggled, this, &QgsTextFormatWidget::mChkNoObstacle_toggled );
80  connect( chkLineOrientationDependent, &QCheckBox::toggled, this, &QgsTextFormatWidget::chkLineOrientationDependent_toggled );
81  connect( mToolButtonConfigureSubstitutes, &QToolButton::clicked, this, &QgsTextFormatWidget::mToolButtonConfigureSubstitutes_clicked );
82 
83  mPreviewScaleComboBox->setMapCanvas( mMapCanvas );
84  mPreviewScaleComboBox->setShowCurrentScaleButton( true );
85  connect( mPreviewScaleComboBox, &QgsScaleWidget::scaleChanged, this, &QgsTextFormatWidget::previewScaleChanged );
86 
87  Q_FOREACH ( QgsUnitSelectionWidget *unitWidget, findChildren<QgsUnitSelectionWidget *>() )
88  {
89  unitWidget->setMapCanvas( mMapCanvas );
90  }
91  mFontSizeUnitWidget->setUnits( QgsUnitTypes::RenderUnitList() << QgsUnitTypes::RenderPoints << QgsUnitTypes::RenderMetersInMapUnits << QgsUnitTypes::RenderMapUnits
92  << QgsUnitTypes::RenderMillimeters << QgsUnitTypes::RenderPixels << QgsUnitTypes::RenderInches );
93  mBufferUnitWidget->setUnits( QgsUnitTypes::RenderUnitList() << QgsUnitTypes::RenderMillimeters << QgsUnitTypes::RenderMetersInMapUnits << QgsUnitTypes::RenderMapUnits << QgsUnitTypes::RenderPixels
94  << QgsUnitTypes::RenderPoints << QgsUnitTypes::RenderInches );
95  mShapeSizeUnitWidget->setUnits( QgsUnitTypes::RenderUnitList() << QgsUnitTypes::RenderMillimeters << QgsUnitTypes::RenderMetersInMapUnits << QgsUnitTypes::RenderMapUnits << QgsUnitTypes::RenderPixels
96  << QgsUnitTypes::RenderPoints << QgsUnitTypes::RenderInches );
97  mShapeOffsetUnitWidget->setUnits( QgsUnitTypes::RenderUnitList() << QgsUnitTypes::RenderMillimeters << QgsUnitTypes::RenderMetersInMapUnits << QgsUnitTypes::RenderMapUnits << QgsUnitTypes::RenderPixels
98  << QgsUnitTypes::RenderPoints << QgsUnitTypes::RenderInches );
99  mShapeRadiusUnitWidget->setUnits( QgsUnitTypes::RenderUnitList() << QgsUnitTypes::RenderMillimeters << QgsUnitTypes::RenderMetersInMapUnits << QgsUnitTypes::RenderMapUnits
100  << QgsUnitTypes::RenderPixels << QgsUnitTypes::RenderPercentage
101  << QgsUnitTypes::RenderPoints << QgsUnitTypes::RenderInches );
102  mShapeStrokeWidthUnitWidget->setUnits( QgsUnitTypes::RenderUnitList() << QgsUnitTypes::RenderMillimeters << QgsUnitTypes::RenderMetersInMapUnits << QgsUnitTypes::RenderMapUnits << QgsUnitTypes::RenderPixels
103  << QgsUnitTypes::RenderPoints << QgsUnitTypes::RenderInches );
104  mShadowOffsetUnitWidget->setUnits( QgsUnitTypes::RenderUnitList() << QgsUnitTypes::RenderMillimeters << QgsUnitTypes::RenderMetersInMapUnits << QgsUnitTypes::RenderMapUnits << QgsUnitTypes::RenderPixels
105  << QgsUnitTypes::RenderPoints << QgsUnitTypes::RenderInches );
106  mShadowRadiusUnitWidget->setUnits( QgsUnitTypes::RenderUnitList() << QgsUnitTypes::RenderMillimeters << QgsUnitTypes::RenderMetersInMapUnits << QgsUnitTypes::RenderMapUnits << QgsUnitTypes::RenderPixels
107  << QgsUnitTypes::RenderPoints << QgsUnitTypes::RenderInches );
108  mPointOffsetUnitWidget->setUnits( QgsUnitTypes::RenderUnitList() << QgsUnitTypes::RenderMillimeters << QgsUnitTypes::RenderMetersInMapUnits << QgsUnitTypes::RenderMapUnits << QgsUnitTypes::RenderPixels
109  << QgsUnitTypes::RenderPoints << QgsUnitTypes::RenderInches );
110  mLineDistanceUnitWidget->setUnits( QgsUnitTypes::RenderUnitList() << QgsUnitTypes::RenderMillimeters << QgsUnitTypes::RenderMetersInMapUnits << QgsUnitTypes::RenderMapUnits << QgsUnitTypes::RenderPixels
111  << QgsUnitTypes::RenderPoints << QgsUnitTypes::RenderInches );
112  mRepeatDistanceUnitWidget->setUnits( QgsUnitTypes::RenderUnitList() << QgsUnitTypes::RenderMillimeters << QgsUnitTypes::RenderMetersInMapUnits << QgsUnitTypes::RenderMapUnits << QgsUnitTypes::RenderPixels
113  << QgsUnitTypes::RenderPoints << QgsUnitTypes::RenderInches );
114 
115  mFontLineHeightSpinBox->setClearValue( 1.0 );
116  mShapeRotationDblSpnBx->setClearValue( 0.0 );
117  mShapeOffsetXSpnBx->setClearValue( 0.0 );
118  mShapeOffsetYSpnBx->setClearValue( 0.0 );
119  mPointOffsetXSpinBox->setClearValue( 0.0 );
120  mPointOffsetYSpinBox->setClearValue( 0.0 );
121  mPointAngleSpinBox->setClearValue( 0.0 );
122  mFontLetterSpacingSpinBox->setClearValue( 0.0 );
123  mFontWordSpacingSpinBox->setClearValue( 0.0 );
124  mZIndexSpinBox->setClearValue( 0.0 );
125 
126  mObstacleTypeComboBox->addItem( tr( "Over the feature's interior" ), QgsPalLayerSettings::PolygonInterior );
127  mObstacleTypeComboBox->addItem( tr( "Over the feature's boundary" ), QgsPalLayerSettings::PolygonBoundary );
128 
129  mOffsetTypeComboBox->addItem( tr( "From point" ), QgsPalLayerSettings::FromPoint );
130  mOffsetTypeComboBox->addItem( tr( "From symbol bounds" ), QgsPalLayerSettings::FromSymbolBounds );
131 
132  mCharDlg = new QgsCharacterSelectorDialog( this );
133 
134  mRefFont = lblFontPreview->font();
135 
136  // internal connections
137  connect( mShadowOffsetAngleDial, &QAbstractSlider::valueChanged, mShadowOffsetAngleSpnBx, &QSpinBox::setValue );
138  connect( mShadowOffsetAngleSpnBx, static_cast < void ( QSpinBox::* )( int ) > ( &QSpinBox::valueChanged ), mShadowOffsetAngleDial, &QAbstractSlider::setValue );
139  connect( mLimitLabelChkBox, &QAbstractButton::toggled, mLimitLabelSpinBox, &QWidget::setEnabled );
140  connect( mCheckBoxSubstituteText, &QAbstractButton::toggled, mToolButtonConfigureSubstitutes, &QWidget::setEnabled );
141 
142  //connections to prevent users removing all line placement positions
143  connect( chkLineAbove, &QAbstractButton::toggled, this, &QgsTextFormatWidget::updateLinePlacementOptions );
144  connect( chkLineBelow, &QAbstractButton::toggled, this, &QgsTextFormatWidget::updateLinePlacementOptions );
145  connect( chkLineOn, &QAbstractButton::toggled, this, &QgsTextFormatWidget::updateLinePlacementOptions );
146 
147  populateFontCapitalsComboBox();
148 
149  // color buttons
150  mPreviewBackgroundBtn->setColorDialogTitle( tr( "Select Fill Color" ) );
151  mPreviewBackgroundBtn->setContext( QStringLiteral( "labeling" ) );
152  mPreviewBackgroundBtn->setColor( QColor( 255, 255, 255 ) );
153  btnTextColor->setColorDialogTitle( tr( "Select Text Color" ) );
154  btnTextColor->setContext( QStringLiteral( "labeling" ) );
155  btnTextColor->setDefaultColor( Qt::black );
156  btnBufferColor->setColorDialogTitle( tr( "Select Buffer Color" ) );
157  btnBufferColor->setContext( QStringLiteral( "labeling" ) );
158  btnBufferColor->setDefaultColor( Qt::white );
159  mShapeStrokeColorBtn->setColorDialogTitle( tr( "Select Stroke Color" ) );
160  mShapeStrokeColorBtn->setContext( QStringLiteral( "labeling" ) );
161  mShapeFillColorBtn->setColorDialogTitle( tr( "Select Fill Color" ) );
162  mShapeFillColorBtn->setContext( QStringLiteral( "labeling" ) );
163  mShadowColorBtn->setColorDialogTitle( tr( "Select Shadow Color" ) );
164  mShadowColorBtn->setContext( QStringLiteral( "labeling" ) );
165  mShadowColorBtn->setDefaultColor( Qt::black );
166 
167  // set up quadrant offset button group
168  mQuadrantBtnGrp = new QButtonGroup( this );
169  mQuadrantBtnGrp->addButton( mPointOffsetAboveLeft, ( int )QgsPalLayerSettings::QuadrantAboveLeft );
170  mQuadrantBtnGrp->addButton( mPointOffsetAbove, ( int )QgsPalLayerSettings::QuadrantAbove );
171  mQuadrantBtnGrp->addButton( mPointOffsetAboveRight, ( int )QgsPalLayerSettings::QuadrantAboveRight );
172  mQuadrantBtnGrp->addButton( mPointOffsetLeft, ( int )QgsPalLayerSettings::QuadrantLeft );
173  mQuadrantBtnGrp->addButton( mPointOffsetOver, ( int )QgsPalLayerSettings::QuadrantOver );
174  mQuadrantBtnGrp->addButton( mPointOffsetRight, ( int )QgsPalLayerSettings::QuadrantRight );
175  mQuadrantBtnGrp->addButton( mPointOffsetBelowLeft, ( int )QgsPalLayerSettings::QuadrantBelowLeft );
176  mQuadrantBtnGrp->addButton( mPointOffsetBelow, ( int )QgsPalLayerSettings::QuadrantBelow );
177  mQuadrantBtnGrp->addButton( mPointOffsetBelowRight, ( int )QgsPalLayerSettings::QuadrantBelowRight );
178  mQuadrantBtnGrp->setExclusive( true );
179 
180  // setup direction symbol(s) button group
181  mDirectSymbBtnGrp = new QButtonGroup( this );
182  mDirectSymbBtnGrp->addButton( mDirectSymbRadioBtnLR, ( int )QgsPalLayerSettings::SymbolLeftRight );
183  mDirectSymbBtnGrp->addButton( mDirectSymbRadioBtnAbove, ( int )QgsPalLayerSettings::SymbolAbove );
184  mDirectSymbBtnGrp->addButton( mDirectSymbRadioBtnBelow, ( int )QgsPalLayerSettings::SymbolBelow );
185  mDirectSymbBtnGrp->setExclusive( true );
186 
187  // upside-down labels button group
188  mUpsidedownBtnGrp = new QButtonGroup( this );
189  mUpsidedownBtnGrp->addButton( mUpsidedownRadioOff, ( int )QgsPalLayerSettings::Upright );
190  mUpsidedownBtnGrp->addButton( mUpsidedownRadioDefined, ( int )QgsPalLayerSettings::ShowDefined );
191  mUpsidedownBtnGrp->addButton( mUpsidedownRadioAll, ( int )QgsPalLayerSettings::ShowAll );
192  mUpsidedownBtnGrp->setExclusive( true );
193 
194  //mShapeCollisionsChkBx->setVisible( false ); // until implemented
195 
196  // post updatePlacementWidgets() connections
197  connect( chkLineAbove, &QAbstractButton::toggled, this, &QgsTextFormatWidget::updatePlacementWidgets );
198  connect( chkLineBelow, &QAbstractButton::toggled, this, &QgsTextFormatWidget::updatePlacementWidgets );
199 
200  // setup point placement button group
201  mPlacePointBtnGrp = new QButtonGroup( this );
202  mPlacePointBtnGrp->addButton( radPredefinedOrder, ( int )QgsPalLayerSettings::OrderedPositionsAroundPoint );
203  mPlacePointBtnGrp->addButton( radAroundPoint, ( int )QgsPalLayerSettings::AroundPoint );
204  mPlacePointBtnGrp->addButton( radOverPoint, ( int )QgsPalLayerSettings::OverPoint );
205  mPlacePointBtnGrp->setExclusive( true );
206  connect( mPlacePointBtnGrp, static_cast<void ( QButtonGroup::* )( int )>( &QButtonGroup::buttonClicked ), this, &QgsTextFormatWidget::updatePlacementWidgets );
207 
208  // setup line placement button group (assigned enum id currently unused)
209  mPlaceLineBtnGrp = new QButtonGroup( this );
210  mPlaceLineBtnGrp->addButton( radLineParallel, ( int )QgsPalLayerSettings::Line );
211  mPlaceLineBtnGrp->addButton( radLineCurved, ( int )QgsPalLayerSettings::Curved );
212  mPlaceLineBtnGrp->addButton( radLineHorizontal, ( int )QgsPalLayerSettings::Horizontal );
213  mPlaceLineBtnGrp->setExclusive( true );
214  connect( mPlaceLineBtnGrp, static_cast<void ( QButtonGroup::* )( int )>( &QButtonGroup::buttonClicked ), this, &QgsTextFormatWidget::updatePlacementWidgets );
215 
216  // setup polygon placement button group (assigned enum id currently unused)
217  mPlacePolygonBtnGrp = new QButtonGroup( this );
218  mPlacePolygonBtnGrp->addButton( radOverCentroid, ( int )QgsPalLayerSettings::OverPoint );
219  mPlacePolygonBtnGrp->addButton( radAroundCentroid, ( int )QgsPalLayerSettings::AroundPoint );
220  mPlacePolygonBtnGrp->addButton( radPolygonHorizontal, ( int )QgsPalLayerSettings::Horizontal );
221  mPlacePolygonBtnGrp->addButton( radPolygonFree, ( int )QgsPalLayerSettings::Free );
222  mPlacePolygonBtnGrp->addButton( radPolygonPerimeter, ( int )QgsPalLayerSettings::Line );
223  mPlacePolygonBtnGrp->addButton( radPolygonPerimeterCurved, ( int )QgsPalLayerSettings::PerimeterCurved );
224  mPlacePolygonBtnGrp->setExclusive( true );
225  connect( mPlacePolygonBtnGrp, static_cast<void ( QButtonGroup::* )( int )>( &QButtonGroup::buttonClicked ), this, &QgsTextFormatWidget::updatePlacementWidgets );
226 
227  // Global settings group for groupboxes' saved/restored collapsed state
228  // maintains state across different dialogs
229  Q_FOREACH ( QgsCollapsibleGroupBox *grpbox, findChildren<QgsCollapsibleGroupBox *>() )
230  {
231  grpbox->setSettingGroup( QStringLiteral( "mAdvLabelingDlg" ) );
232  }
233 
234  connect( groupBox_mPreview,
235  &QgsCollapsibleGroupBoxBasic::collapsedStateChanged,
236  this,
237  &QgsTextFormatWidget::collapseSample );
238 
239  // get rid of annoying outer focus rect on Mac
240  mLabelingOptionsListWidget->setAttribute( Qt::WA_MacShowFocusRect, false );
241 
242  QgsSettings settings;
243 
244  // reset horiz stretch of left side of options splitter (set to 1 for previewing in Qt Designer)
245  QSizePolicy policy( mLabelingOptionsListFrame->sizePolicy() );
246  policy.setHorizontalStretch( 0 );
247  mLabelingOptionsListFrame->setSizePolicy( policy );
248  if ( !settings.contains( QStringLiteral( "/Windows/Labeling/OptionsSplitState" ) ) )
249  {
250  // set left list widget width on initial showing
251  QList<int> splitsizes;
252  splitsizes << 115;
253  mLabelingOptionsSplitter->setSizes( splitsizes );
254  }
255 
256  // set up reverse connection from stack to list
257  connect( mLabelStackedWidget, &QStackedWidget::currentChanged, this, &QgsTextFormatWidget::optionsStackedWidget_CurrentChanged );
258 
259  // restore dialog, splitters and current tab
260  mFontPreviewSplitter->restoreState( settings.value( QStringLiteral( "Windows/Labeling/FontPreviewSplitState" ) ).toByteArray() );
261  mLabelingOptionsSplitter->restoreState( settings.value( QStringLiteral( "Windows/Labeling/OptionsSplitState" ) ).toByteArray() );
262 
263  mLabelingOptionsListWidget->setCurrentRow( settings.value( QStringLiteral( "Windows/Labeling/Tab" ), 0 ).toInt() );
264 
265  mBufferEffect.reset( QgsPaintEffectRegistry::defaultStack() );
266  connect( mBufferEffectWidget, &QgsEffectStackCompactWidget::changed, this, &QgsTextFormatWidget::updatePreview );
267  mBufferEffectWidget->setPaintEffect( mBufferEffect.get() );
268  mBackgroundEffect.reset( QgsPaintEffectRegistry::defaultStack() );
269  connect( mBackgroundEffectWidget, &QgsEffectStackCompactWidget::changed, this, &QgsTextFormatWidget::updatePreview );
270  mBackgroundEffectWidget->setPaintEffect( mBackgroundEffect.get() );
271 
272  setDockMode( false );
273 
274 
275  QList<QWidget *> widgets;
276  widgets << btnBufferColor
277  << btnTextColor
278  << chkLabelPerFeaturePart
279  << chkLineAbove
280  << chkLineBelow
281  << chkLineOn
282  << chkLineOrientationDependent
283  << chkMergeLines
284  << chkPreserveRotation
285  << comboBlendMode
286  << comboBufferBlendMode
287  << mAlwaysShowDDBtn
288  << mBufferBlendModeDDBtn
289  << mBufferColorDDBtn
290  << mBufferDrawChkBx
291  << mBufferDrawDDBtn
292  << mBufferJoinStyleComboBox
293  << mBufferJoinStyleDDBtn
294  << mBufferSizeDDBtn
295  << mBufferOpacityDDBtn
296  << mBufferTranspFillChbx
297  << mBufferOpacityWidget
298  << mBufferUnitsDDBtn
299  << mCentroidDDBtn
300  << mCentroidInsideCheckBox
301  << mChkNoObstacle
302  << mCoordAlignmentHDDBtn
303  << mCoordAlignmentVDDBtn
304  << mCoordRotationDDBtn
305  << mCoordXDDBtn
306  << mCoordYDDBtn
307  << mDirectSymbChkBx
308  << mDirectSymbDDBtn
309  << mDirectSymbLeftDDBtn
310  << mDirectSymbLeftLineEdit
311  << mDirectSymbPlacementDDBtn
312  << mDirectSymbRevChkBx
313  << mDirectSymbRevDDBtn
314  << mDirectSymbRightDDBtn
315  << mDirectSymbRightLineEdit
316  << mFitInsidePolygonCheckBox
317  << mFontBlendModeDDBtn
318  << mFontBoldDDBtn
319  << mFontCapitalsComboBox
320  << mFontCaseDDBtn
321  << mFontColorDDBtn
322  << mFontDDBtn
323  << mFontItalicDDBtn
324  << mFontLetterSpacingDDBtn
325  << mFontLetterSpacingSpinBox
326  << mFontLimitPixelChkBox
327  << mFontLimitPixelDDBtn
328  << mFontLineHeightDDBtn
329  << mFontLineHeightSpinBox
330  << mFontMaxPixelDDBtn
331  << mFontMaxPixelSpinBox
332  << mFontMinPixelDDBtn
333  << mFontMinPixelSpinBox
334  << mFontMultiLineAlignComboBox
335  << mFontMultiLineAlignDDBtn
336  << mFontSizeDDBtn
337  << mFontSizeSpinBox
338  << mFontStrikeoutDDBtn
339  << mFontStyleComboBox
340  << mFontStyleDDBtn
341  << mFontOpacityDDBtn
342  << mTextOpacityWidget
343  << mFontUnderlineDDBtn
344  << mFontUnitsDDBtn
345  << mFontWordSpacingDDBtn
346  << mFontWordSpacingSpinBox
347  << mFormatNumChkBx
348  << mFormatNumDDBtn
349  << mFormatNumDecimalsDDBtn
350  << mFormatNumDecimalsSpnBx
351  << mFormatNumPlusSignChkBx
352  << mFormatNumPlusSignDDBtn
353  << mIsObstacleDDBtn
354  << mLimitLabelChkBox
355  << mLimitLabelSpinBox
356  << mLineDistanceDDBtn
357  << mLineDistanceSpnBx
358  << mLineDistanceUnitDDBtn
359  << mLineDistanceUnitWidget
360  << mMaxCharAngleDDBtn
361  << mMaxCharAngleInDSpinBox
362  << mMaxCharAngleOutDSpinBox
363  << mMinSizeSpinBox
364  << mObstacleFactorDDBtn
365  << mObstacleFactorSlider
366  << mObstacleTypeComboBox
367  << mOffsetTypeComboBox
368  << mPalShowAllLabelsForLayerChkBx
369  << mPointAngleSpinBox
370  << mPointOffsetDDBtn
371  << mPointOffsetUnitsDDBtn
372  << mPointOffsetUnitWidget
373  << mPointOffsetXSpinBox
374  << mPointOffsetYSpinBox
375  << mPointPositionOrderDDBtn
376  << mPointQuadOffsetDDBtn
377  << mPreviewBackgroundBtn
378  << mPreviewTextEdit
379  << mPriorityDDBtn
380  << mPrioritySlider
381  << mRepeatDistanceDDBtn
382  << mRepeatDistanceSpinBox
383  << mRepeatDistanceUnitDDBtn
384  << mRepeatDistanceUnitWidget
385  << mScaleBasedVisibilityChkBx
386  << mScaleBasedVisibilityDDBtn
387  << mScaleBasedVisibilityMaxDDBtn
388  << mMaxScaleWidget
389  << mScaleBasedVisibilityMinDDBtn
390  << mMinScaleWidget
391  << mShadowBlendCmbBx
392  << mShadowBlendDDBtn
393  << mShadowColorBtn
394  << mShadowColorDDBtn
395  << mShadowDrawChkBx
396  << mShadowDrawDDBtn
397  << mShadowOffsetAngleDDBtn
398  << mShadowOffsetAngleSpnBx
399  << mShadowOffsetDDBtn
400  << mShadowOffsetGlobalChkBx
401  << mShadowOffsetSpnBx
402  << mShadowOffsetUnitsDDBtn
403  << mShadowOffsetUnitWidget
404  << mShadowRadiusAlphaChkBx
405  << mShadowRadiusDDBtn
406  << mShadowRadiusDblSpnBx
407  << mShadowRadiusUnitsDDBtn
408  << mShadowRadiusUnitWidget
409  << mShadowScaleDDBtn
410  << mShadowScaleSpnBx
411  << mShadowOpacityDDBtn
412  << mShadowOpacityWidget
413  << mShadowUnderCmbBx
414  << mShadowUnderDDBtn
415  << mShapeBlendCmbBx
416  << mShapeBlendModeDDBtn
417  << mShapeStrokeColorBtn
418  << mShapeStrokeColorDDBtn
419  << mShapeStrokeUnitsDDBtn
420  << mShapeStrokeWidthDDBtn
421  << mShapeStrokeWidthSpnBx
422  << mShapeStrokeWidthUnitWidget
423  << mShapeDrawChkBx
424  << mShapeDrawDDBtn
425  << mShapeFillColorBtn
426  << mShapeFillColorDDBtn
427  << mShapeOffsetDDBtn
428  << mShapeOffsetUnitsDDBtn
429  << mShapeOffsetXSpnBx
430  << mShapeOffsetYSpnBx
431  << mShapeOffsetUnitWidget
432  << mShapePenStyleCmbBx
433  << mShapePenStyleDDBtn
434  << mShapeRadiusDDBtn
435  << mShapeRadiusUnitsDDBtn
436  << mShapeRadiusXDbSpnBx
437  << mShapeRadiusYDbSpnBx
438  << mShapeRotationCmbBx
439  << mShapeRotationDDBtn
440  << mShapeRotationDblSpnBx
441  << mShapeRotationTypeDDBtn
442  << mShapeRadiusUnitWidget
443  << mShapeSVGPathDDBtn
444  << mShapeSVGPathLineEdit
445  << mShapeSizeCmbBx
446  << mShapeSizeTypeDDBtn
447  << mShapeSizeUnitsDDBtn
448  << mShapeSizeUnitWidget
449  << mShapeSizeXDDBtn
450  << mShapeSizeXSpnBx
451  << mShapeSizeYDDBtn
452  << mShapeSizeYSpnBx
453  << mShapeOpacityDDBtn
454  << mBackgroundOpacityWidget
455  << mShapeTypeCmbBx
456  << mShapeTypeDDBtn
457  << mShowLabelDDBtn
458  << mWrapCharDDBtn
459  << mZIndexDDBtn
460  << mZIndexSpinBox
461  << spinBufferSize
462  << wrapCharacterEdit
463  << mCentroidRadioVisible
464  << mCentroidRadioWhole
465  << mDirectSymbRadioBtnAbove
466  << mDirectSymbRadioBtnBelow
467  << mDirectSymbRadioBtnLR
468  << mUpsidedownRadioAll
469  << mUpsidedownRadioDefined
470  << mUpsidedownRadioOff
471  << radAroundCentroid
472  << radAroundPoint
473  << radLineCurved
474  << radLineHorizontal
475  << radLineParallel
476  << radOverCentroid
477  << radOverPoint
478  << radPolygonFree
479  << radPolygonHorizontal
480  << radPolygonPerimeter
481  << radPolygonPerimeterCurved
482  << radPredefinedOrder
483  << mFieldExpressionWidget
484  << mCheckBoxSubstituteText;
485  connectValueChanged( widgets, SLOT( updatePreview() ) );
486 
487  connect( mQuadrantBtnGrp, static_cast<void ( QButtonGroup::* )( int )>( &QButtonGroup::buttonClicked ), this, &QgsTextFormatWidget::updatePreview );
488 
489  // set correct initial tab to match displayed setting page
490  whileBlocking( mOptionsTab )->setCurrentIndex( mLabelStackedWidget->currentIndex() );
491 
492  if ( mMapCanvas )
493  {
494  lblFontPreview->setMapUnits( mMapCanvas->mapSettings().mapUnits() );
495  mPreviewScaleComboBox->setScale( mMapCanvas->mapSettings().scale() );
496  }
497 }
498 
499 void QgsTextFormatWidget::setWidgetMode( QgsTextFormatWidget::Mode mode )
500 {
501  mWidgetMode = mode;
502  switch ( mode )
503  {
504  case Labeling:
505  toggleDDButtons( true );
506  break;
507 
508  case Text:
509  toggleDDButtons( false );
510  delete mLabelingOptionsListWidget->takeItem( 6 );
511  delete mLabelingOptionsListWidget->takeItem( 5 );
512  mOptionsTab->removeTab( 6 );
513  mOptionsTab->removeTab( 5 );
514 
515  frameLabelWith->hide();
516  mDirectSymbolsFrame->hide();
517  mFormatNumFrame->hide();
518  mFormatNumChkBx->hide();
519  mFormatNumDDBtn->hide();
520  mSubstitutionsFrame->hide();
521  mFontBoldBtn->hide();
522  mFontItalicBtn->hide();
523 
524  break;
525  }
526 }
527 
528 void QgsTextFormatWidget::toggleDDButtons( bool visible )
529 {
530  Q_FOREACH ( QgsPropertyOverrideButton *button, findChildren< QgsPropertyOverrideButton * >() )
531  {
532  button->setVisible( visible );
533  }
534 }
535 
536 void QgsTextFormatWidget::setDockMode( bool enabled )
537 {
538  mOptionsTab->setVisible( enabled );
539  mOptionsTab->setTabToolTip( 0, tr( "Text" ) );
540  mOptionsTab->setTabToolTip( 1, tr( "Formatting" ) );
541  mOptionsTab->setTabToolTip( 2, tr( "Buffer" ) );
542  mOptionsTab->setTabToolTip( 3, tr( "Background" ) );
543  mOptionsTab->setTabToolTip( 4, tr( "Shadow" ) );
544  mOptionsTab->setTabToolTip( 5, tr( "Placement" ) );
545  mOptionsTab->setTabToolTip( 6, tr( "Rendering" ) );
546 
547  mLabelingOptionsListFrame->setVisible( !enabled );
548  groupBox_mPreview->setVisible( !enabled );
549  mDockMode = enabled;
550 }
551 
552 void QgsTextFormatWidget::connectValueChanged( const QList<QWidget *> &widgets, const char *slot )
553 {
554  Q_FOREACH ( QWidget *widget, widgets )
555  {
556  if ( QgsPropertyOverrideButton *w = qobject_cast<QgsPropertyOverrideButton *>( widget ) )
557  {
558  connect( w, SIGNAL( changed() ), this, slot );
559  }
560  else if ( QgsFieldExpressionWidget *w = qobject_cast< QgsFieldExpressionWidget *>( widget ) )
561  {
562  connect( w, SIGNAL( fieldChanged( QString ) ), this, slot );
563  }
564  else if ( QgsOpacityWidget *w = qobject_cast< QgsOpacityWidget *>( widget ) )
565  {
566  connect( w, SIGNAL( opacityChanged( double ) ), this, slot );
567  }
568  else if ( QgsScaleWidget *w = qobject_cast< QgsScaleWidget *>( widget ) )
569  {
570  connect( w, SIGNAL( scaleChanged( double ) ), this, slot );
571  }
572  else if ( QgsUnitSelectionWidget *w = qobject_cast<QgsUnitSelectionWidget *>( widget ) )
573  {
574  connect( w, SIGNAL( changed() ), this, slot );
575  }
576  else if ( QComboBox *w = qobject_cast<QComboBox *>( widget ) )
577  {
578  connect( w, SIGNAL( currentIndexChanged( int ) ), this, slot );
579  }
580  else if ( QSpinBox *w = qobject_cast<QSpinBox *>( widget ) )
581  {
582  connect( w, SIGNAL( valueChanged( int ) ), this, slot );
583  }
584  else if ( QDoubleSpinBox *w = qobject_cast<QDoubleSpinBox *>( widget ) )
585  {
586  connect( w, SIGNAL( valueChanged( double ) ), this, slot );
587  }
588  else if ( QgsColorButton *w = qobject_cast<QgsColorButton *>( widget ) )
589  {
590  connect( w, SIGNAL( colorChanged( QColor ) ), this, slot );
591  }
592  else if ( QCheckBox *w = qobject_cast<QCheckBox *>( widget ) )
593  {
594  connect( w, SIGNAL( toggled( bool ) ), this, slot );
595  }
596  else if ( QRadioButton *w = qobject_cast<QRadioButton *>( widget ) )
597  {
598  connect( w, SIGNAL( toggled( bool ) ), this, slot );
599  }
600  else if ( QLineEdit *w = qobject_cast<QLineEdit *>( widget ) )
601  {
602  connect( w, SIGNAL( textEdited( QString ) ), this, slot );
603  }
604  else if ( QSlider *w = qobject_cast<QSlider *>( widget ) )
605  {
606  connect( w, SIGNAL( valueChanged( int ) ), this, slot );
607  }
608  else
609  {
610  QgsLogger::warning( QStringLiteral( "Could not create connection for widget %1" ).arg( widget->objectName() ) );
611  }
612  }
613 }
614 
615 void QgsTextFormatWidget::updateWidgetForFormat( const QgsTextFormat &format )
616 {
617  QgsTextBufferSettings buffer = format.buffer();
618  QgsTextBackgroundSettings background = format.background();
619  QgsTextShadowSettings shadow = format.shadow();
620 
621  // buffer
622  mBufferDrawChkBx->setChecked( buffer.enabled() );
623  spinBufferSize->setValue( buffer.size() );
624  mBufferUnitWidget->setUnit( buffer.sizeUnit() );
625  mBufferUnitWidget->setMapUnitScale( buffer.sizeMapUnitScale() );
626  btnBufferColor->setColor( buffer.color() );
627  mBufferOpacityWidget->setOpacity( buffer.opacity() );
628  mBufferJoinStyleComboBox->setPenJoinStyle( buffer.joinStyle() );
629  mBufferTranspFillChbx->setChecked( buffer.fillBufferInterior() );
630  comboBufferBlendMode->setBlendMode( buffer.blendMode() );
631  if ( buffer.paintEffect() )
632  mBufferEffect.reset( buffer.paintEffect()->clone() );
633  else
634  {
635  mBufferEffect.reset( QgsPaintEffectRegistry::defaultStack() );
636  mBufferEffect->setEnabled( false );
637  }
638  mBufferEffectWidget->setPaintEffect( mBufferEffect.get() );
639 
640  mFontSizeUnitWidget->setUnit( format.sizeUnit() );
641  mFontSizeUnitWidget->setMapUnitScale( format.sizeMapUnitScale() );
642  mRefFont = format.font();
643  mFontSizeSpinBox->setValue( format.size() );
644  btnTextColor->setColor( format.color() );
645  mTextOpacityWidget->setOpacity( format.opacity() );
646  comboBlendMode->setBlendMode( format.blendMode() );
647 
648  mFontWordSpacingSpinBox->setValue( format.font().wordSpacing() );
649  mFontLetterSpacingSpinBox->setValue( format.font().letterSpacing() );
650 
651  QgsFontUtils::updateFontViaStyle( mRefFont, format.namedStyle() );
652  updateFont( mRefFont );
653 
654  // show 'font not found' if substitution has occurred (should come after updateFont())
655  mFontMissingLabel->setVisible( !format.fontFound() );
656  if ( !format.fontFound() )
657  {
658  QString missingTxt = tr( "%1 not found. Default substituted." );
659  QString txtPrepend = tr( "Chosen font" );
660  if ( !format.resolvedFontFamily().isEmpty() )
661  {
662  txtPrepend = QStringLiteral( "'%1'" ).arg( format.resolvedFontFamily() );
663  }
664  mFontMissingLabel->setText( missingTxt.arg( txtPrepend ) );
665 
666  // ensure user is sent to 'Text style' section to see notice
667  mLabelingOptionsListWidget->setCurrentRow( 0 );
668  }
669  mFontLineHeightSpinBox->setValue( format.lineHeight() );
670 
671  // shape background
672  mShapeDrawChkBx->setChecked( background.enabled() );
673  mShapeTypeCmbBx->blockSignals( true );
674  mShapeTypeCmbBx->setCurrentIndex( background.type() );
675  mShapeTypeCmbBx->blockSignals( false );
676  mShapeSVGPathLineEdit->setText( background.svgFile() );
677 
678  mShapeSizeCmbBx->setCurrentIndex( background.sizeType() );
679  mShapeSizeXSpnBx->setValue( background.size().width() );
680  mShapeSizeYSpnBx->setValue( background.size().height() );
681  mShapeSizeUnitWidget->setUnit( background.sizeUnit() );
682  mShapeSizeUnitWidget->setMapUnitScale( background.sizeMapUnitScale() );
683  mShapeRotationCmbBx->setCurrentIndex( background.rotationType() );
684  mShapeRotationDblSpnBx->setEnabled( background.rotationType() != QgsTextBackgroundSettings::RotationSync );
685  mShapeRotationDDBtn->setEnabled( background.rotationType() != QgsTextBackgroundSettings::RotationSync );
686  mShapeRotationDblSpnBx->setValue( background.rotation() );
687  mShapeOffsetXSpnBx->setValue( background.offset().x() );
688  mShapeOffsetYSpnBx->setValue( background.offset().y() );
689  mShapeOffsetUnitWidget->setUnit( background.offsetUnit() );
690  mShapeOffsetUnitWidget->setMapUnitScale( background.offsetMapUnitScale() );
691  mShapeRadiusXDbSpnBx->setValue( background.radii().width() );
692  mShapeRadiusYDbSpnBx->setValue( background.radii().height() );
693  mShapeRadiusUnitWidget->setUnit( background.radiiUnit() );
694  mShapeRadiusUnitWidget->setMapUnitScale( background.radiiMapUnitScale() );
695 
696  mShapeFillColorBtn->setColor( background.fillColor() );
697  mShapeStrokeColorBtn->setColor( background.strokeColor() );
698  mShapeStrokeWidthSpnBx->setValue( background.strokeWidth() );
699  mShapeStrokeWidthUnitWidget->setUnit( background.strokeWidthUnit() );
700  mShapeStrokeWidthUnitWidget->setMapUnitScale( background.strokeWidthMapUnitScale() );
701  mShapePenStyleCmbBx->setPenJoinStyle( background.joinStyle() );
702 
703  mBackgroundOpacityWidget->setOpacity( background.opacity() );
704  mShapeBlendCmbBx->setBlendMode( background.blendMode() );
705 
706  mLoadSvgParams = false;
707  mShapeTypeCmbBx_currentIndexChanged( background.type() ); // force update of shape background gui
708 
709  if ( background.paintEffect() )
710  mBackgroundEffect.reset( background.paintEffect()->clone() );
711  else
712  {
713  mBackgroundEffect.reset( QgsPaintEffectRegistry::defaultStack() );
714  mBackgroundEffect->setEnabled( false );
715  }
716  mBackgroundEffectWidget->setPaintEffect( mBackgroundEffect.get() );
717 
718  // drop shadow
719  mShadowDrawChkBx->setChecked( shadow.enabled() );
720  mShadowUnderCmbBx->setCurrentIndex( shadow.shadowPlacement() );
721  mShadowOffsetAngleSpnBx->setValue( shadow.offsetAngle() );
722  mShadowOffsetSpnBx->setValue( shadow.offsetDistance() );
723  mShadowOffsetUnitWidget->setUnit( shadow.offsetUnit() );
724  mShadowOffsetUnitWidget->setMapUnitScale( shadow.offsetMapUnitScale() );
725  mShadowOffsetGlobalChkBx->setChecked( shadow.offsetGlobal() );
726 
727  mShadowRadiusDblSpnBx->setValue( shadow.blurRadius() );
728  mShadowRadiusUnitWidget->setUnit( shadow.blurRadiusUnit() );
729  mShadowRadiusUnitWidget->setMapUnitScale( shadow.blurRadiusMapUnitScale() );
730  mShadowRadiusAlphaChkBx->setChecked( shadow.blurAlphaOnly() );
731  mShadowOpacityWidget->setOpacity( shadow.opacity() );
732  mShadowScaleSpnBx->setValue( shadow.scale() );
733 
734  mShadowColorBtn->setColor( shadow.color() );
735  mShadowBlendCmbBx->setBlendMode( shadow.blendMode() );
736 
737 }
738 
739 QgsTextFormatWidget::~QgsTextFormatWidget()
740 {
741  QgsSettings settings;
742  settings.setValue( QStringLiteral( "Windows/Labeling/FontPreviewSplitState" ), mFontPreviewSplitter->saveState() );
743  settings.setValue( QStringLiteral( "Windows/Labeling/OptionsSplitState" ), mLabelingOptionsSplitter->saveState() );
744  settings.setValue( QStringLiteral( "Windows/Labeling/Tab" ), mLabelingOptionsListWidget->currentRow() );
745 }
746 
747 QgsTextFormat QgsTextFormatWidget::format() const
748 {
749  QgsTextFormat format;
750  format.setColor( btnTextColor->color() );
751  format.setFont( mRefFont );
752  format.setSize( mFontSizeSpinBox->value() );
753  format.setNamedStyle( mFontStyleComboBox->currentText() );
754  format.setOpacity( mTextOpacityWidget->opacity() );
755  format.setBlendMode( comboBlendMode->blendMode() );
756  format.setSizeUnit( mFontSizeUnitWidget->unit() );
757  format.setSizeMapUnitScale( mFontSizeUnitWidget->getMapUnitScale() );
758  format.setLineHeight( mFontLineHeightSpinBox->value() );
759 
760  // buffer
761  QgsTextBufferSettings buffer;
762  buffer.setEnabled( mBufferDrawChkBx->isChecked() );
763  buffer.setSize( spinBufferSize->value() );
764  buffer.setColor( btnBufferColor->color() );
765  buffer.setOpacity( mBufferOpacityWidget->opacity() );
766  buffer.setSizeUnit( mBufferUnitWidget->unit() );
767  buffer.setSizeMapUnitScale( mBufferUnitWidget->getMapUnitScale() );
768  buffer.setJoinStyle( mBufferJoinStyleComboBox->penJoinStyle() );
769  buffer.setFillBufferInterior( mBufferTranspFillChbx->isChecked() );
770  buffer.setBlendMode( comboBufferBlendMode->blendMode() );
771  if ( mBufferEffect && !QgsPaintEffectRegistry::isDefaultStack( mBufferEffect.get() ) )
772  buffer.setPaintEffect( mBufferEffect->clone() );
773  else
774  buffer.setPaintEffect( nullptr );
775  format.setBuffer( buffer );
776 
777  // shape background
778  QgsTextBackgroundSettings background;
779  background.setEnabled( mShapeDrawChkBx->isChecked() );
780  background.setType( ( QgsTextBackgroundSettings::ShapeType )mShapeTypeCmbBx->currentIndex() );
781  background.setSvgFile( mShapeSVGPathLineEdit->text() );
782  background.setSizeType( ( QgsTextBackgroundSettings::SizeType )mShapeSizeCmbBx->currentIndex() );
783  background.setSize( QSizeF( mShapeSizeXSpnBx->value(), mShapeSizeYSpnBx->value() ) );
784  background.setSizeUnit( mShapeSizeUnitWidget->unit() );
785  background.setSizeMapUnitScale( mShapeSizeUnitWidget->getMapUnitScale() );
786  background.setRotationType( ( QgsTextBackgroundSettings::RotationType )( mShapeRotationCmbBx->currentIndex() ) );
787  background.setRotation( mShapeRotationDblSpnBx->value() );
788  background.setOffset( QPointF( mShapeOffsetXSpnBx->value(), mShapeOffsetYSpnBx->value() ) );
789  background.setOffsetUnit( mShapeOffsetUnitWidget->unit() );
790  background.setOffsetMapUnitScale( mShapeOffsetUnitWidget->getMapUnitScale() );
791  background.setRadii( QSizeF( mShapeRadiusXDbSpnBx->value(), mShapeRadiusYDbSpnBx->value() ) );
792  background.setRadiiUnit( mShapeRadiusUnitWidget->unit() );
793  background.setRadiiMapUnitScale( mShapeRadiusUnitWidget->getMapUnitScale() );
794 
795  background.setFillColor( mShapeFillColorBtn->color() );
796  background.setStrokeColor( mShapeStrokeColorBtn->color() );
797  background.setStrokeWidth( mShapeStrokeWidthSpnBx->value() );
798  background.setStrokeWidthUnit( mShapeStrokeWidthUnitWidget->unit() );
799  background.setStrokeWidthMapUnitScale( mShapeStrokeWidthUnitWidget->getMapUnitScale() );
800  background.setJoinStyle( mShapePenStyleCmbBx->penJoinStyle() );
801  background.setOpacity( mBackgroundOpacityWidget->opacity() );
802  background.setBlendMode( mShapeBlendCmbBx->blendMode() );
803  if ( mBackgroundEffect && !QgsPaintEffectRegistry::isDefaultStack( mBackgroundEffect.get() ) )
804  background.setPaintEffect( mBackgroundEffect->clone() );
805  else
806  background.setPaintEffect( nullptr );
807  format.setBackground( background );
808 
809  // drop shadow
810  QgsTextShadowSettings shadow;
811  shadow.setEnabled( mShadowDrawChkBx->isChecked() );
812  shadow.setShadowPlacement( ( QgsTextShadowSettings::ShadowPlacement )mShadowUnderCmbBx->currentIndex() );
813  shadow.setOffsetAngle( mShadowOffsetAngleSpnBx->value() );
814  shadow.setOffsetDistance( mShadowOffsetSpnBx->value() );
815  shadow.setOffsetUnit( mShadowOffsetUnitWidget->unit() );
816  shadow.setOffsetMapUnitScale( mShadowOffsetUnitWidget->getMapUnitScale() );
817  shadow.setOffsetGlobal( mShadowOffsetGlobalChkBx->isChecked() );
818  shadow.setBlurRadius( mShadowRadiusDblSpnBx->value() );
819  shadow.setBlurRadiusUnit( mShadowRadiusUnitWidget->unit() );
820  shadow.setBlurRadiusMapUnitScale( mShadowRadiusUnitWidget->getMapUnitScale() );
821  shadow.setBlurAlphaOnly( mShadowRadiusAlphaChkBx->isChecked() );
822  shadow.setOpacity( mShadowOpacityWidget->opacity() );
823  shadow.setScale( mShadowScaleSpnBx->value() );
824  shadow.setColor( mShadowColorBtn->color() );
825  shadow.setBlendMode( mShadowBlendCmbBx->blendMode() );
826  format.setShadow( shadow );
827 
828  return format;
829 }
830 
831 void QgsTextFormatWidget::optionsStackedWidget_CurrentChanged( int indx )
832 {
833  mLabelingOptionsListWidget->blockSignals( true );
834  mLabelingOptionsListWidget->setCurrentRow( indx );
835  mLabelingOptionsListWidget->blockSignals( false );
836 }
837 
838 void QgsTextFormatWidget::collapseSample( bool collapse )
839 {
840  if ( collapse )
841  {
842  QList<int> splitSizes = mFontPreviewSplitter->sizes();
843  if ( splitSizes[0] > groupBox_mPreview->height() )
844  {
845  int delta = splitSizes[0] - groupBox_mPreview->height();
846  splitSizes[0] -= delta;
847  splitSizes[1] += delta;
848  mFontPreviewSplitter->setSizes( splitSizes );
849  }
850  }
851 }
852 
853 void QgsTextFormatWidget::changeTextColor( const QColor &color )
854 {
855  Q_UNUSED( color )
856  updatePreview();
857 }
858 
859 void QgsTextFormatWidget::updateFont( const QFont &font )
860 {
861  // update background reference font
862  if ( font != mRefFont )
863  {
864  mRefFont = font;
865  }
866 
867  // test if font is actually available
868  // NOTE: QgsFontUtils::fontMatchOnSystem may fail here, just crosscheck family
869  mFontMissingLabel->setVisible( !QgsFontUtils::fontFamilyMatchOnSystem( mRefFont.family() ) );
870 
871  mDirectSymbLeftLineEdit->setFont( mRefFont );
872  mDirectSymbRightLineEdit->setFont( mRefFont );
873 
874  blockFontChangeSignals( true );
875  mFontFamilyCmbBx->setCurrentFont( mRefFont );
876  populateFontStyleComboBox();
877  int idx = mFontCapitalsComboBox->findData( QVariant( ( unsigned int ) mRefFont.capitalization() ) );
878  mFontCapitalsComboBox->setCurrentIndex( idx == -1 ? 0 : idx );
879  mFontUnderlineBtn->setChecked( mRefFont.underline() );
880  mFontStrikethroughBtn->setChecked( mRefFont.strikeOut() );
881  blockFontChangeSignals( false );
882 
883  // update font name with font face
884 // font.setPixelSize( 24 );
885 
886  updatePreview();
887 }
888 
889 void QgsTextFormatWidget::blockFontChangeSignals( bool blk )
890 {
891  mFontFamilyCmbBx->blockSignals( blk );
892  mFontStyleComboBox->blockSignals( blk );
893  mFontCapitalsComboBox->blockSignals( blk );
894  mFontUnderlineBtn->blockSignals( blk );
895  mFontStrikethroughBtn->blockSignals( blk );
896  mFontWordSpacingSpinBox->blockSignals( blk );
897  mFontLetterSpacingSpinBox->blockSignals( blk );
898 }
899 
900 void QgsTextFormatWidget::updatePreview()
901 {
902  // In dock mode we don't have a preview we
903  // just let stuff know we have changed because
904  // there might be live updates connected.
905  if ( mDockMode )
906  {
907  emit widgetChanged();
908  return;
909  }
910 
911  scrollPreview();
912  lblFontPreview->setFormat( format() );
913 }
914 
915 void QgsTextFormatWidget::scrollPreview()
916 {
917  scrollArea_mPreview->ensureVisible( 0, 0, 0, 0 );
918 }
919 
920 void QgsTextFormatWidget::setPreviewBackground( const QColor &color )
921 {
922  scrollArea_mPreview->widget()->setStyleSheet( QStringLiteral( "background: rgb(%1, %2, %3);" ).arg( QString::number( color.red() ),
923  QString::number( color.green() ),
924  QString::number( color.blue() ) ) );
925 }
926 
927 void QgsTextFormatWidget::changeBufferColor( const QColor &color )
928 {
929  Q_UNUSED( color )
930  updatePreview();
931 }
932 
933 void QgsTextFormatWidget::updatePlacementWidgets()
934 {
935  QWidget *curWdgt = stackedPlacement->currentWidget();
936 
937  bool showLineFrame = false;
938  bool showCentroidFrame = false;
939  bool showQuadrantFrame = false;
940  bool showFixedQuadrantFrame = false;
941  bool showPlacementPriorityFrame = false;
942  bool showOffsetTypeFrame = false;
943  bool showOffsetFrame = false;
944  bool showDistanceFrame = false;
945  bool showRotationFrame = false;
946  bool showMaxCharAngleFrame = false;
947 
948  bool enableMultiLinesFrame = true;
949 
950  if ( ( curWdgt == pagePoint && radAroundPoint->isChecked() )
951  || ( curWdgt == pagePolygon && radAroundCentroid->isChecked() ) )
952  {
953  showCentroidFrame = ( curWdgt == pagePolygon && radAroundCentroid->isChecked() );
954  showDistanceFrame = true;
955  //showRotationFrame = true; // TODO: uncomment when supported
956  if ( curWdgt == pagePoint )
957  {
958  showQuadrantFrame = true;
959  }
960  }
961  else if ( ( curWdgt == pagePoint && radOverPoint->isChecked() )
962  || ( curWdgt == pagePolygon && radOverCentroid->isChecked() ) )
963  {
964  showCentroidFrame = ( curWdgt == pagePolygon && radOverCentroid->isChecked() );
965  showQuadrantFrame = true;
966  showFixedQuadrantFrame = true;
967  showOffsetFrame = true;
968  showRotationFrame = true;
969  }
970  else if ( curWdgt == pagePoint && radPredefinedOrder->isChecked() )
971  {
972  showDistanceFrame = true;
973  showPlacementPriorityFrame = true;
974  showOffsetTypeFrame = true;
975  }
976  else if ( ( curWdgt == pageLine && radLineParallel->isChecked() )
977  || ( curWdgt == pagePolygon && radPolygonPerimeter->isChecked() )
978  || ( curWdgt == pageLine && radLineCurved->isChecked() )
979  || ( curWdgt == pagePolygon && radPolygonPerimeterCurved->isChecked() ) )
980  {
981  showLineFrame = true;
982  showDistanceFrame = true;
983  //showRotationFrame = true; // TODO: uncomment when supported
984 
985  bool offline = chkLineAbove->isChecked() || chkLineBelow->isChecked();
986  chkLineOrientationDependent->setEnabled( offline );
987  mPlacementDistanceFrame->setEnabled( offline );
988 
989  bool isCurved = ( curWdgt == pageLine && radLineCurved->isChecked() )
990  || ( curWdgt == pagePolygon && radPolygonPerimeterCurved->isChecked() );
991  showMaxCharAngleFrame = isCurved;
992  // TODO: enable mMultiLinesFrame when supported for curved labels
993  enableMultiLinesFrame = !isCurved;
994  }
995 
996  mPlacementLineFrame->setVisible( showLineFrame );
997  mPlacementCentroidFrame->setVisible( showCentroidFrame );
998  mPlacementQuadrantFrame->setVisible( showQuadrantFrame );
999  mPlacementFixedQuadrantFrame->setVisible( showFixedQuadrantFrame );
1000  mPlacementCartographicFrame->setVisible( showPlacementPriorityFrame );
1001  mPlacementOffsetFrame->setVisible( showOffsetFrame );
1002  mPlacementDistanceFrame->setVisible( showDistanceFrame );
1003  mPlacementOffsetTypeFrame->setVisible( showOffsetTypeFrame );
1004  mPlacementRotationFrame->setVisible( showRotationFrame );
1005  mPlacementRepeatDistanceFrame->setVisible( curWdgt == pageLine || ( curWdgt == pagePolygon &&
1006  ( radPolygonPerimeter->isChecked() || radPolygonPerimeterCurved->isChecked() ) ) );
1007  mPlacementMaxCharAngleFrame->setVisible( showMaxCharAngleFrame );
1008 
1009  mMultiLinesFrame->setEnabled( enableMultiLinesFrame );
1010 }
1011 
1012 void QgsTextFormatWidget::populateFontCapitalsComboBox()
1013 {
1014  mFontCapitalsComboBox->addItem( tr( "No change" ), QVariant( 0 ) );
1015  mFontCapitalsComboBox->addItem( tr( "All uppercase" ), QVariant( 1 ) );
1016  mFontCapitalsComboBox->addItem( tr( "All lowercase" ), QVariant( 2 ) );
1017  // Small caps doesn't work right with QPainterPath::addText()
1018  // https://bugreports.qt-project.org/browse/QTBUG-13965
1019 // mFontCapitalsComboBox->addItem( tr( "Small caps" ), QVariant( 3 ) );
1020  mFontCapitalsComboBox->addItem( tr( "Capitalize first letter" ), QVariant( 4 ) );
1021 }
1022 
1023 void QgsTextFormatWidget::populateFontStyleComboBox()
1024 {
1025  mFontStyleComboBox->clear();
1026  QStringList styles = mFontDB.styles( mRefFont.family() );
1027  Q_FOREACH ( const QString &style, styles )
1028  {
1029  mFontStyleComboBox->addItem( style );
1030  }
1031 
1032  QString targetStyle = mFontDB.styleString( mRefFont );
1033  if ( !styles.contains( targetStyle ) )
1034  {
1035  QFont f = QFont( mRefFont.family() );
1036  targetStyle = QFontInfo( f ).styleName();
1037  mRefFont.setStyleName( targetStyle );
1038  }
1039  int curIndx = 0;
1040  int stylIndx = mFontStyleComboBox->findText( targetStyle );
1041  if ( stylIndx > -1 )
1042  {
1043  curIndx = stylIndx;
1044  }
1045 
1046  mFontStyleComboBox->setCurrentIndex( curIndx );
1047 }
1048 
1049 void QgsTextFormatWidget::mFontSizeSpinBox_valueChanged( double d )
1050 {
1051  mRefFont.setPointSizeF( d );
1052  updateFont( mRefFont );
1053 }
1054 
1055 void QgsTextFormatWidget::mFontCapitalsComboBox_currentIndexChanged( int index )
1056 {
1057  int capitalsindex = mFontCapitalsComboBox->itemData( index ).toUInt();
1058  mRefFont.setCapitalization( ( QFont::Capitalization ) capitalsindex );
1059  updateFont( mRefFont );
1060 }
1061 
1062 void QgsTextFormatWidget::mFontFamilyCmbBx_currentFontChanged( const QFont &f )
1063 {
1064  mRefFont.setFamily( f.family() );
1065  updateFont( mRefFont );
1066 }
1067 
1068 void QgsTextFormatWidget::mFontStyleComboBox_currentIndexChanged( const QString &text )
1069 {
1070  QgsFontUtils::updateFontViaStyle( mRefFont, text );
1071  updateFont( mRefFont );
1072 }
1073 
1074 void QgsTextFormatWidget::mFontUnderlineBtn_toggled( bool ckd )
1075 {
1076  mRefFont.setUnderline( ckd );
1077  updateFont( mRefFont );
1078 }
1079 
1080 void QgsTextFormatWidget::mFontStrikethroughBtn_toggled( bool ckd )
1081 {
1082  mRefFont.setStrikeOut( ckd );
1083  updateFont( mRefFont );
1084 }
1085 
1086 void QgsTextFormatWidget::mFontWordSpacingSpinBox_valueChanged( double spacing )
1087 {
1088  mRefFont.setWordSpacing( spacing );
1089  updateFont( mRefFont );
1090 }
1091 
1092 void QgsTextFormatWidget::mFontLetterSpacingSpinBox_valueChanged( double spacing )
1093 {
1094  mRefFont.setLetterSpacing( QFont::AbsoluteSpacing, spacing );
1095  updateFont( mRefFont );
1096 }
1097 
1098 void QgsTextFormatWidget::mFontSizeUnitWidget_changed()
1099 {
1100  // disable pixel size limiting for labels defined in points
1101  if ( mFontSizeUnitWidget->unit() != QgsUnitTypes::RenderMapUnits )
1102  {
1103  mFontLimitPixelChkBox->setChecked( false );
1104  }
1105  else if ( mMinPixelLimit == 0 )
1106  {
1107  // initial minimum trigger value set, turn on pixel size limiting by default
1108  // for labels defined in map units (ignored after first settings save)
1109  mFontLimitPixelChkBox->setChecked( true );
1110  }
1111  updateFont( mRefFont );
1112 }
1113 
1114 void QgsTextFormatWidget::mFontMinPixelSpinBox_valueChanged( int px )
1115 {
1116  // ensure max font pixel size for map unit labels can't be lower than min
1117  mFontMaxPixelSpinBox->setMinimum( px );
1118  mFontMaxPixelSpinBox->update();
1119 }
1120 
1121 void QgsTextFormatWidget::mFontMaxPixelSpinBox_valueChanged( int px )
1122 {
1123  // ensure max font pixel size for map unit labels can't be lower than min
1124  if ( px < mFontMinPixelSpinBox->value() )
1125  {
1126  mFontMaxPixelSpinBox->blockSignals( true );
1127  mFontMaxPixelSpinBox->setValue( mFontMinPixelSpinBox->value() );
1128  mFontMaxPixelSpinBox->blockSignals( false );
1129  }
1130  mFontMaxPixelSpinBox->setMinimum( mFontMinPixelSpinBox->value() );
1131 }
1132 
1133 void QgsTextFormatWidget::mBufferUnitWidget_changed()
1134 {
1135  updateFont( mRefFont );
1136 }
1137 
1138 void QgsTextFormatWidget::mCoordXDDBtn_activated( bool active )
1139 {
1140  if ( !active ) //no data defined alignment without data defined position
1141  {
1142  enableDataDefinedAlignment( false );
1143  }
1144  else if ( mCoordYDDBtn->isActive() )
1145  {
1146  enableDataDefinedAlignment( true );
1147  }
1148 }
1149 
1150 void QgsTextFormatWidget::mCoordYDDBtn_activated( bool active )
1151 {
1152  if ( !active ) //no data defined alignment without data defined position
1153  {
1154  enableDataDefinedAlignment( false );
1155  }
1156  else if ( mCoordXDDBtn->isActive() )
1157  {
1158  enableDataDefinedAlignment( true );
1159  }
1160 }
1161 
1162 void QgsTextFormatWidget::mShapeTypeCmbBx_currentIndexChanged( int index )
1163 {
1164  // shape background
1165  bool isRect = ( ( QgsTextBackgroundSettings::ShapeType )index == QgsTextBackgroundSettings::ShapeRectangle
1166  || ( QgsTextBackgroundSettings::ShapeType )index == QgsTextBackgroundSettings::ShapeSquare );
1167  bool isSVG = ( ( QgsTextBackgroundSettings::ShapeType )index == QgsTextBackgroundSettings::ShapeSVG );
1168 
1169  showBackgroundPenStyle( isRect );
1170  showBackgroundRadius( isRect );
1171 
1172  mShapeSVGPathFrame->setVisible( isSVG );
1173  // symbology SVG renderer only supports size^2 scaling, so we only use the x size spinbox
1174  mShapeSizeYLabel->setVisible( !isSVG );
1175  mShapeSizeYSpnBx->setVisible( !isSVG );
1176  mShapeSizeYDDBtn->setVisible( !isSVG );
1177  mShapeSizeXLabel->setText( tr( "Size%1" ).arg( !isSVG ? tr( " X" ) : QLatin1String( "" ) ) );
1178 
1179  // SVG parameter setting doesn't support color's alpha component yet
1180  mShapeFillColorBtn->setAllowOpacity( !isSVG );
1181  mShapeFillColorBtn->setButtonBackground();
1182  mShapeStrokeColorBtn->setAllowOpacity( !isSVG );
1183  mShapeStrokeColorBtn->setButtonBackground();
1184 
1185  // configure SVG parameter widgets
1186  mShapeSVGParamsBtn->setVisible( isSVG );
1187  if ( isSVG )
1188  {
1189  updateSvgWidgets( mShapeSVGPathLineEdit->text() );
1190  }
1191  else
1192  {
1193  mShapeFillColorLabel->setEnabled( true );
1194  mShapeFillColorBtn->setEnabled( true );
1195  mShapeFillColorDDBtn->setEnabled( true );
1196  mShapeStrokeColorLabel->setEnabled( true );
1197  mShapeStrokeColorBtn->setEnabled( true );
1198  mShapeStrokeColorDDBtn->setEnabled( true );
1199  mShapeStrokeWidthLabel->setEnabled( true );
1200  mShapeStrokeWidthSpnBx->setEnabled( true );
1201  mShapeStrokeWidthDDBtn->setEnabled( true );
1202  }
1203  // TODO: fix overriding SVG symbol's stroke width units in QgsSvgCache
1204  // currently broken, fall back to symbol units only
1205  mShapeStrokeWidthUnitWidget->setVisible( !isSVG );
1206  mShapeSVGUnitsLabel->setVisible( isSVG );
1207  mShapeStrokeUnitsDDBtn->setEnabled( !isSVG );
1208 }
1209 
1210 void QgsTextFormatWidget::mShapeSVGPathLineEdit_textChanged( const QString &text )
1211 {
1212  updateSvgWidgets( text );
1213 }
1214 
1215 void QgsTextFormatWidget::updateLinePlacementOptions()
1216 {
1217  int numOptionsChecked = ( chkLineAbove->isChecked() ? 1 : 0 ) +
1218  ( chkLineBelow->isChecked() ? 1 : 0 ) +
1219  ( chkLineOn->isChecked() ? 1 : 0 );
1220 
1221  if ( numOptionsChecked == 1 )
1222  {
1223  //prevent unchecking last option
1224  chkLineAbove->setEnabled( !chkLineAbove->isChecked() );
1225  chkLineBelow->setEnabled( !chkLineBelow->isChecked() );
1226  chkLineOn->setEnabled( !chkLineOn->isChecked() );
1227  }
1228  else
1229  {
1230  chkLineAbove->setEnabled( true );
1231  chkLineBelow->setEnabled( true );
1232  chkLineOn->setEnabled( true );
1233  }
1234 }
1235 
1236 void QgsTextFormatWidget::onSubstitutionsChanged( const QgsStringReplacementCollection &substitutions )
1237 {
1238  mSubstitutions = substitutions;
1239  emit widgetChanged();
1240 }
1241 
1242 void QgsTextFormatWidget::previewScaleChanged( double scale )
1243 {
1244  lblFontPreview->setScale( scale );
1245 }
1246 
1247 void QgsTextFormatWidget::updateSvgWidgets( const QString &svgPath )
1248 {
1249  if ( mShapeSVGPathLineEdit->text() != svgPath )
1250  {
1251  mShapeSVGPathLineEdit->setText( svgPath );
1252  }
1253 
1254  QString resolvedPath = QgsSymbolLayerUtils::svgSymbolNameToPath( svgPath, QgsProject::instance()->pathResolver() );
1255  bool validSVG = QFileInfo::exists( resolvedPath );
1256 
1257  // draw red text for path field if invalid (path can't be resolved)
1258  mShapeSVGPathLineEdit->setStyleSheet( QString( !validSVG ? "QLineEdit{ color: rgb(225, 0, 0); }" : "" ) );
1259  mShapeSVGPathLineEdit->setToolTip( !validSVG ? tr( "File not found" ) : resolvedPath );
1260 
1261  QColor fill, stroke;
1262  double strokeWidth = 0.0;
1263  bool fillParam = false, strokeParam = false, strokeWidthParam = false;
1264  if ( validSVG )
1265  {
1266  QgsApplication::svgCache()->containsParams( resolvedPath, fillParam, fill, strokeParam, stroke, strokeWidthParam, strokeWidth );
1267  }
1268 
1269  mShapeSVGParamsBtn->setEnabled( validSVG && ( fillParam || strokeParam || strokeWidthParam ) );
1270 
1271  mShapeFillColorLabel->setEnabled( validSVG && fillParam );
1272  mShapeFillColorBtn->setEnabled( validSVG && fillParam );
1273  mShapeFillColorDDBtn->setEnabled( validSVG && fillParam );
1274  if ( mLoadSvgParams && validSVG && fillParam )
1275  mShapeFillColorBtn->setColor( fill );
1276 
1277  mShapeStrokeColorLabel->setEnabled( validSVG && strokeParam );
1278  mShapeStrokeColorBtn->setEnabled( validSVG && strokeParam );
1279  mShapeStrokeColorDDBtn->setEnabled( validSVG && strokeParam );
1280  if ( mLoadSvgParams && validSVG && strokeParam )
1281  mShapeStrokeColorBtn->setColor( stroke );
1282 
1283  mShapeStrokeWidthLabel->setEnabled( validSVG && strokeWidthParam );
1284  mShapeStrokeWidthSpnBx->setEnabled( validSVG && strokeWidthParam );
1285  mShapeStrokeWidthDDBtn->setEnabled( validSVG && strokeWidthParam );
1286  if ( mLoadSvgParams && validSVG && strokeWidthParam )
1287  mShapeStrokeWidthSpnBx->setValue( strokeWidth );
1288 
1289  // TODO: fix overriding SVG symbol's stroke width units in QgsSvgCache
1290  // currently broken, fall back to symbol's
1291  //mShapeStrokeWidthUnitWidget->setEnabled( validSVG && strokeWidthParam );
1292  //mShapeStrokeUnitsDDBtn->setEnabled( validSVG && strokeWidthParam );
1293  mShapeSVGUnitsLabel->setEnabled( validSVG && strokeWidthParam );
1294 }
1295 
1296 void QgsTextFormatWidget::mShapeSVGSelectorBtn_clicked()
1297 {
1298  QgsSvgSelectorDialog svgDlg( this );
1299  svgDlg.setWindowTitle( tr( "Select SVG file" ) );
1300  svgDlg.svgSelector()->setSvgPath( mShapeSVGPathLineEdit->text().trimmed() );
1301 
1302  if ( svgDlg.exec() == QDialog::Accepted )
1303  {
1304  QString svgPath = svgDlg.svgSelector()->currentSvgPath();
1305  if ( !svgPath.isEmpty() )
1306  {
1307  mShapeSVGPathLineEdit->setText( svgPath );
1308  }
1309  }
1310 }
1311 
1312 void QgsTextFormatWidget::mShapeSVGParamsBtn_clicked()
1313 {
1314  QString svgPath = mShapeSVGPathLineEdit->text();
1315  mLoadSvgParams = true;
1316  updateSvgWidgets( svgPath );
1317  mLoadSvgParams = false;
1318 }
1319 
1320 void QgsTextFormatWidget::mShapeRotationCmbBx_currentIndexChanged( int index )
1321 {
1322  mShapeRotationDblSpnBx->setEnabled( ( QgsTextBackgroundSettings::RotationType )index != QgsTextBackgroundSettings::RotationSync );
1323  mShapeRotationDDBtn->setEnabled( ( QgsTextBackgroundSettings::RotationType )index != QgsTextBackgroundSettings::RotationSync );
1324 }
1325 
1326 void QgsTextFormatWidget::mPreviewTextEdit_textChanged( const QString &text )
1327 {
1328  lblFontPreview->setText( text );
1329  updatePreview();
1330 }
1331 
1332 void QgsTextFormatWidget::mPreviewTextBtn_clicked()
1333 {
1334  mPreviewTextEdit->setText( QStringLiteral( "Lorem Ipsum" ) );
1335  updatePreview();
1336 }
1337 
1338 void QgsTextFormatWidget::mPreviewBackgroundBtn_colorChanged( const QColor &color )
1339 {
1340  setPreviewBackground( color );
1341 }
1342 
1343 void QgsTextFormatWidget::mDirectSymbLeftToolBtn_clicked()
1344 {
1345  bool gotChar = false;
1346  QChar dirSymb = mCharDlg->selectCharacter( &gotChar, mRefFont, mFontDB.styleString( mRefFont ) );
1347 
1348  if ( !gotChar )
1349  return;
1350 
1351  if ( !dirSymb.isNull() )
1352  mDirectSymbLeftLineEdit->setText( QString( dirSymb ) );
1353 }
1354 
1355 void QgsTextFormatWidget::mDirectSymbRightToolBtn_clicked()
1356 {
1357  bool gotChar = false;
1358  QChar dirSymb = mCharDlg->selectCharacter( &gotChar, mRefFont, mFontDB.styleString( mRefFont ) );
1359 
1360  if ( !gotChar )
1361  return;
1362 
1363  if ( !dirSymb.isNull() )
1364  mDirectSymbRightLineEdit->setText( QString( dirSymb ) );
1365 }
1366 
1367 void QgsTextFormatWidget::mChkNoObstacle_toggled( bool active )
1368 {
1369  mPolygonObstacleTypeFrame->setEnabled( active );
1370  mObstaclePriorityFrame->setEnabled( active );
1371 }
1372 
1373 void QgsTextFormatWidget::chkLineOrientationDependent_toggled( bool active )
1374 {
1375  if ( active )
1376  {
1377  chkLineAbove->setText( tr( "Left of line" ) );
1378  chkLineBelow->setText( tr( "Right of line" ) );
1379  }
1380  else
1381  {
1382  chkLineAbove->setText( tr( "Above line" ) );
1383  chkLineBelow->setText( tr( "Below line" ) );
1384  }
1385 }
1386 
1387 
1388 void QgsTextFormatWidget::mToolButtonConfigureSubstitutes_clicked()
1389 {
1390  QgsPanelWidget *panel = QgsPanelWidget::findParentPanel( this );
1391  if ( panel && panel->dockMode() )
1392  {
1393  QgsSubstitutionListWidget *widget = new QgsSubstitutionListWidget( panel );
1394  widget->setPanelTitle( tr( "Substitutions" ) );
1395  widget->setSubstitutions( mSubstitutions );
1396  connect( widget, &QgsSubstitutionListWidget::substitutionsChanged, this, &QgsTextFormatWidget::onSubstitutionsChanged );
1397  panel->openPanel( widget );
1398  return;
1399  }
1400 
1401  QgsSubstitutionListDialog dlg( this );
1402  dlg.setSubstitutions( mSubstitutions );
1403  if ( dlg.exec() == QDialog::Accepted )
1404  {
1405  mSubstitutions = dlg.substitutions();
1406  emit widgetChanged();
1407  }
1408 }
1409 
1410 void QgsTextFormatWidget::showBackgroundRadius( bool show )
1411 {
1412  mShapeRadiusLabel->setVisible( show );
1413  mShapeRadiusXDbSpnBx->setVisible( show );
1414 
1415  mShapeRadiusYDbSpnBx->setVisible( show );
1416 
1417  mShapeRadiusUnitWidget->setVisible( show );
1418 
1419  mShapeRadiusDDBtn->setVisible( show );
1420  mShapeRadiusUnitsDDBtn->setVisible( show );
1421 }
1422 
1423 void QgsTextFormatWidget::showBackgroundPenStyle( bool show )
1424 {
1425  mShapePenStyleLabel->setVisible( show );
1426  mShapePenStyleCmbBx->setVisible( show );
1427 
1428  mShapePenStyleDDBtn->setVisible( show );
1429 }
1430 
1431 void QgsTextFormatWidget::enableDataDefinedAlignment( bool enable )
1432 {
1433  mCoordAlignmentFrame->setEnabled( enable );
1434 }
1435 
1436 
1437 //
1438 // QgsTextFormatDialog
1439 //
1440 
1441 QgsTextFormatDialog::QgsTextFormatDialog( const QgsTextFormat &format, QgsMapCanvas *mapCanvas, QWidget *parent, Qt::WindowFlags fl )
1442  : QDialog( parent, fl )
1443 {
1444  setWindowTitle( tr( "Text Settings" ) );
1445 
1446  mFormatWidget = new QgsTextFormatWidget( format, mapCanvas, this );
1447  mFormatWidget->layout()->setContentsMargins( 0, 0, 0, 0 );
1448 
1449  QVBoxLayout *layout = new QVBoxLayout( this );
1450  layout->addWidget( mFormatWidget );
1451 
1452  QDialogButtonBox *buttonBox = new QDialogButtonBox( QDialogButtonBox::Ok | QDialogButtonBox::Cancel, Qt::Horizontal, this );
1453  layout->addWidget( buttonBox );
1454 
1455  setLayout( layout );
1456 
1457  QgsSettings settings;
1458  restoreGeometry( settings.value( QStringLiteral( "Windows/TextFormatDialog/geometry" ) ).toByteArray() );
1459 
1460  connect( buttonBox->button( QDialogButtonBox::Ok ), &QAbstractButton::clicked, this, &QDialog::accept );
1461  connect( buttonBox->button( QDialogButtonBox::Cancel ), &QAbstractButton::clicked, this, &QDialog::reject );
1462 }
1463 
1464 QgsTextFormatDialog::~QgsTextFormatDialog()
1465 {
1466  QgsSettings settings;
1467  settings.setValue( QStringLiteral( "Windows/TextFormatDialog/geometry" ), saveGeometry() );
1468 }
1469 
1470 QgsTextFormat QgsTextFormatDialog::format() const
1471 {
1472  return mFormatWidget->format();
1473 }
1474 
1475 QgsTextFormatPanelWidget::QgsTextFormatPanelWidget( const QgsTextFormat &format, QgsMapCanvas *mapCanvas, QWidget *parent )
1476  : QgsPanelWidgetWrapper( new QgsTextFormatWidget( format, mapCanvas ), parent )
1477 {
1478  mFormatWidget = qobject_cast< QgsTextFormatWidget * >( widget() );
1479  connect( mFormatWidget, &QgsTextFormatWidget::widgetChanged, this, &QgsPanelWidget::widgetChanged );
1480 }
1481 
1482 QgsTextFormat QgsTextFormatPanelWidget::format() const
1483 {
1484  return mFormatWidget->format();
1485 }
1486 
1487 void QgsTextFormatPanelWidget::setDockMode( bool dockMode )
1488 {
1489  mFormatWidget->setDockMode( dockMode );
1490  QgsPanelWidgetWrapper::setDockMode( dockMode );
1491 }
QgsPanelWidget::openPanel
void openPanel(QgsPanelWidget *panel)
Open a panel or dialog depending on dock mode setting If dock mode is true this method will emit the ...
Definition: qgspanelwidget.cpp:68
QgsTextBufferSettings::blendMode
QPainter::CompositionMode blendMode() const
Returns the blending mode used for drawing the buffer.
Definition: qgstextrenderer.cpp:167
QgsApplication::svgCache
static QgsSvgCache * svgCache()
Returns the application&#39;s SVG cache, used for caching SVG images and handling parameter replacement w...
Definition: qgsapplication.cpp:1650
QgsTextBackgroundSettings::strokeColor
QColor strokeColor() const
Returns the color used for outlining the background shape.
Definition: qgstextrenderer.cpp:551
QgsFieldExpressionWidget
The QgsFieldExpressionWidget class reates a widget to choose fields and edit expressions It contains ...
Definition: qgsfieldexpressionwidget.h:46
QgsTextShadowSettings::setScale
void setScale(int scale)
Sets the scaling used for the drop shadow (in percentage of original size).
Definition: qgstextrenderer.cpp:1051
QgsUnitTypes::RenderMetersInMapUnits
Meters value as Map units.
Definition: qgsunittypes.h:109
QgsTextFormat::setLineHeight
void setLineHeight(double height)
Sets the line height for text.
Definition: qgstextrenderer.cpp:1366
QgsTextBackgroundSettings::setRadiiUnit
void setRadiiUnit(QgsUnitTypes::RenderUnit units)
Sets the units used for the shape&#39;s radii.
Definition: qgstextrenderer.cpp:506
QgsTextBackgroundSettings::setStrokeWidth
void setStrokeWidth(double width)
Sets the width of the shape&#39;s stroke (stroke).
Definition: qgstextrenderer.cpp:566
QgsTextBackgroundSettings::RotationType
RotationType
Methods for determining the rotation of the background shape.
Definition: qgstextrenderer.h:271
QgsTextShadowSettings::setOffsetMapUnitScale
void setOffsetMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale object for the shadow offset distance.
Definition: qgstextrenderer.cpp:981
QgsSubstitutionListWidget::setSubstitutions
void setSubstitutions(const QgsStringReplacementCollection &substitutions)
Sets the list of substitutions to show in the widget.
Definition: qgssubstitutionlistwidget.cpp:38
QgsTextFormat::setOpacity
void setOpacity(double opacity)
Sets the text&#39;s opacity.
Definition: qgstextrenderer.cpp:1346
QgsTextBackgroundSettings::setStrokeWidthMapUnitScale
void setStrokeWidthMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale object for the shape stroke width.
Definition: qgstextrenderer.cpp:586
QgsTextShadowSettings::setOffsetUnit
void setOffsetUnit(QgsUnitTypes::RenderUnit units)
Sets the units used for the shadow&#39;s offset.
Definition: qgstextrenderer.cpp:971
QgsPanelWidgetWrapper::widget
QWidget * widget()
Returns the internal widget that is wrapped in this panel.
Definition: qgspanelwidget.h:198
QgsTextShadowSettings::shadowPlacement
QgsTextShadowSettings::ShadowPlacement shadowPlacement() const
Returns the placement for the drop shadow.
Definition: qgstextrenderer.cpp:936
QgsTextBackgroundSettings::radii
QSizeF radii() const
Returns the radii used for rounding the corners of shapes.
Definition: qgstextrenderer.cpp:491
QgsTextBackgroundSettings::size
QSizeF size() const
Returns the size of the background shape.
Definition: qgstextrenderer.cpp:411
QgsTextFormat::opacity
double opacity() const
Returns the text&#39;s opacity.
Definition: qgstextrenderer.cpp:1341
QgsPanelWidget::dockMode
bool dockMode()
Return the dock mode state.
Definition: qgspanelwidget.h:81
QgsTextBackgroundSettings::setSizeUnit
void setSizeUnit(QgsUnitTypes::RenderUnit unit)
Sets the units used for the shape&#39;s size.
Definition: qgstextrenderer.cpp:426
QgsTextFormat::fontFound
bool fontFound() const
Returns true if the specified font was found on the system, or false if the font was not found and a ...
Definition: qgstextrenderer.h:1245
QgsTextShadowSettings::blendMode
QPainter::CompositionMode blendMode() const
Returns the blending mode used for drawing the drop shadow.
Definition: qgstextrenderer.cpp:1066
QgsTextBackgroundSettings::offset
QPointF offset() const
Returns the offset used for drawing the background shape.
Definition: qgstextrenderer.cpp:461
QgsTextBackgroundSettings::fillColor
QColor fillColor() const
Returns the color used for filing the background shape.
Definition: qgstextrenderer.cpp:541
QgsTextBackgroundSettings::strokeWidthMapUnitScale
QgsMapUnitScale strokeWidthMapUnitScale() const
Returns the map unit scale object for the shape stroke width.
Definition: qgstextrenderer.cpp:581
QgsTextFormatWidget::setDockMode
void setDockMode(bool enabled)
Sets whether the widget should be shown in a compact dock mode.
Definition: qgstextformatwidget.cpp:536
QgsSettings
This class is a composition of two QSettings instances:
Definition: qgssettings.h:57
QgsSettings::contains
bool contains(const QString &key, const QgsSettings::Section section=QgsSettings::NoSection) const
Returns true if there exists a setting called key; returns false otherwise.
Definition: qgssettings.cpp:178
QgsCollapsibleGroupBox
A groupbox that collapses/expands when toggled and can save its collapsed and checked states...
Definition: qgscollapsiblegroupbox.h:183
QgsTextShadowSettings::ShadowPlacement
ShadowPlacement
Placement positions for text shadow.
Definition: qgstextrenderer.h:704
QgsPalLayerSettings::SymbolBelow
Place direction symbols on below label.
Definition: qgspallabeling.h:221
QgsTextFormat::shadow
QgsTextShadowSettings & shadow()
Returns a reference to the text drop shadow settings.
Definition: qgstextrenderer.h:1036
QgsScaleWidget
A combobox which lets the user select map scale from predefined list and highlights nearest to curren...
Definition: qgsscalewidget.h:34
QgsTextShadowSettings::blurRadius
double blurRadius() const
Returns the blur radius for the shadow.
Definition: qgstextrenderer.cpp:996
QgsTextBackgroundSettings::opacity
double opacity() const
Returns the background shape&#39;s opacity.
Definition: qgstextrenderer.cpp:521
QgsLogger::warning
static void warning(const QString &msg)
Goes to qWarning.
Definition: qgslogger.cpp:121
QgsTextFormat::setSizeMapUnitScale
void setSizeMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale object for the size.
Definition: qgstextrenderer.cpp:1316
QgsTextBackgroundSettings::setStrokeColor
void setStrokeColor(const QColor &color)
Sets the color used for outlining the background shape.
Definition: qgstextrenderer.cpp:556
QgsTextBufferSettings::setSize
void setSize(double size)
Sets the size of the buffer.
Definition: qgstextrenderer.cpp:102
QgsTextBackgroundSettings::strokeWidth
double strokeWidth() const
Returns the width of the shape&#39;s stroke (stroke).
Definition: qgstextrenderer.cpp:561
QgsTextBufferSettings::setSizeUnit
void setSizeUnit(QgsUnitTypes::RenderUnit unit)
Sets the units used for the buffer size.
Definition: qgstextrenderer.cpp:112
QgsTextShadowSettings::offsetDistance
double offsetDistance() const
Returns the distance for offsetting the position of the shadow from the text.
Definition: qgstextrenderer.cpp:956
QgsTextFormatWidget::mUpsidedownBtnGrp
QButtonGroup * mUpsidedownBtnGrp
Upside down labels button group.
Definition: qgstextformatwidget.h:126
QgsTextFormat::setFont
void setFont(const QFont &font)
Sets the font used for rendering text.
Definition: qgstextrenderer.cpp:1281
QgsTextBufferSettings::setJoinStyle
void setJoinStyle(Qt::PenJoinStyle style)
Sets the join style used for drawing the buffer.
Definition: qgstextrenderer.cpp:162
QgsPaintEffectRegistry::isDefaultStack
static bool isDefaultStack(QgsPaintEffect *effect)
Tests whether a paint effect matches the default effects stack.
Definition: qgspainteffectregistry.cpp:133
QgsCollapsibleGroupBoxBasic::collapsedStateChanged
void collapsedStateChanged(bool collapsed)
Signal emitted when groupbox collapsed/expanded state is changed, and when first shown.
QgsPalLayerSettings::OrderedPositionsAroundPoint
Candidates are placed in predefined positions around a point. Preference is given to positions with g...
Definition: qgspallabeling.h:145
QgsTextBackgroundSettings::setOffsetUnit
void setOffsetUnit(QgsUnitTypes::RenderUnit units)
Sets the units used for the shape&#39;s offset.
Definition: qgstextrenderer.cpp:476
QgsColorButton
A cross platform button subclass for selecting colors.
Definition: qgscolorbutton.h:36
QgsTextFormat::color
QColor color() const
Returns the color that text will be rendered in.
Definition: qgstextrenderer.cpp:1331
QgsTextBufferSettings::setFillBufferInterior
void setFillBufferInterior(bool fill)
Sets whether the interior of the buffer will be filled in.
Definition: qgstextrenderer.cpp:142
QgsTextShadowSettings::setBlurRadius
void setBlurRadius(double blurRadius)
Sets the blur radius for the shadow.
Definition: qgstextrenderer.cpp:1001
QgsTextBufferSettings::setPaintEffect
void setPaintEffect(QgsPaintEffect *effect)
Sets the current paint effect for the buffer.
Definition: qgstextrenderer.cpp:182
QgsTextShadowSettings::setOpacity
void setOpacity(double opacity)
Sets the shadow&#39;s opacity.
Definition: qgstextrenderer.cpp:1041
QgsTextBackgroundSettings::setSizeMapUnitScale
void setSizeMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale object for the shape size.
Definition: qgstextrenderer.cpp:436
QgsTextFormatPanelWidget::setDockMode
void setDockMode(bool dockMode) override
Set the widget in dock mode which tells the widget to emit panel widgets and not open dialogs...
Definition: qgstextformatwidget.cpp:1487
QgsTextFormatWidget::updateWidgetForFormat
void updateWidgetForFormat(const QgsTextFormat &format)
Updates the widget&#39;s state to reflect the settings in a QgsTextFormat.
Definition: qgstextformatwidget.cpp:615
QgsTextFormatDialog::format
QgsTextFormat format() const
Returns the current formatting settings defined by the widget.
Definition: qgstextformatwidget.cpp:1470
QgsCharacterSelectorDialog
A dialog for selecting a single character from a single font.
Definition: qgscharacterselectordialog.h:34
QgsTextFormat::setBackground
void setBackground(const QgsTextBackgroundSettings &backgroundSettings)
Sets the text&#39;s background settings.q.
Definition: qgstextrenderer.h:1030
QgsPanelWidget
Base class for any widget that can be shown as a inline panel.
Definition: qgspanelwidget.h:27
QgsTextBackgroundSettings::setJoinStyle
void setJoinStyle(Qt::PenJoinStyle style)
Sets the join style used for drawing the background shape.
Definition: qgstextrenderer.cpp:596
QgsSymbolLayerUtils::svgSymbolNameToPath
static QString svgSymbolNameToPath(QString name, const QgsPathResolver &pathResolver)
Get SVG symbol&#39;s path from its name.
Definition: qgssymbollayerutils.cpp:3656
QgsPropertyOverrideButton::activated
void activated(bool isActive)
Emitted when the activated status of the widget changes.
QgsTextBackgroundSettings
Container for settings relating to a text background object.
Definition: qgstextrenderer.h:242
QgsTextFormatWidget
A widget for customising text formatting settings.
Definition: qgstextformatwidget.h:49
QgsUnitTypes::RenderPercentage
Percentage of another measurement (e.g., canvas size, feature size)
Definition: qgsunittypes.h:105
QgsTextBackgroundSettings::offsetMapUnitScale
QgsMapUnitScale offsetMapUnitScale() const
Returns the map unit scale object for the shape offset.
Definition: qgstextrenderer.cpp:481
QgsTextBackgroundSettings::setRadiiMapUnitScale
void setRadiiMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale object for the shape radii.
Definition: qgstextrenderer.cpp:516
QgsTextShadowSettings::setBlurRadiusUnit
void setBlurRadiusUnit(QgsUnitTypes::RenderUnit units)
Sets the units used for the shadow&#39;s blur radius.
Definition: qgstextrenderer.cpp:1011
QgsScaleWidget::scaleChanged
void scaleChanged(double scale)
Emitted when user has finished editing/selecting a new scale.
QgsTextShadowSettings::setBlurRadiusMapUnitScale
void setBlurRadiusMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale object for the shadow blur radius.
Definition: qgstextrenderer.cpp:1021
QgsUnitTypes::RenderUnitList
QList< QgsUnitTypes::RenderUnit > RenderUnitList
List of render units.
Definition: qgsunittypes.h:173
QgsMapCanvas
Map canvas is a class for displaying all GIS data types on a canvas.
Definition: qgsmapcanvas.h:74
QgsTextFormatWidget::Labeling
Show labeling settings in addition to text formatting settings.
Definition: qgstextformatwidget.h:90
QgsTextBackgroundSettings::type
ShapeType type() const
Returns the type of background shape (e.g., square, ellipse, SVG).
Definition: qgstextrenderer.cpp:381
QgsTextBackgroundSettings::setOffset
void setOffset(QPointF offset)
Sets the offset used for drawing the background shape.
Definition: qgstextrenderer.cpp:466
QgsPaintEffect::clone
virtual QgsPaintEffect * clone() const =0
Duplicates an effect by creating a deep copy of the effect.
QgsPanelWidget::setDockMode
virtual void setDockMode(bool dockMode)
Set the widget in dock mode which tells the widget to emit panel widgets and not open dialogs...
Definition: qgspanelwidget.cpp:43
QgsTextBufferSettings::joinStyle
Qt::PenJoinStyle joinStyle() const
Returns the buffer join style.
Definition: qgstextrenderer.cpp:157
QgsPalLayerSettings::Horizontal
Arranges candidates following the curvature of a line feature. Applies to line layers only...
Definition: qgspallabeling.h:143
QgsMapSettings::mapUnits
QgsUnitTypes::DistanceUnit mapUnits() const
Get units of map&#39;s geographical coordinates - used for scale calculation.
Definition: qgsmapsettings.cpp:330
QgsTextBufferSettings::sizeMapUnitScale
QgsMapUnitScale sizeMapUnitScale() const
Returns the map unit scale object for the buffer size.
Definition: qgstextrenderer.cpp:117
QgsGuiUtils::saveGeometry
void saveGeometry(QWidget *widget, const QString &keyName)
Save the wigget geometry into settings.
Definition: qgsguiutils.cpp:205
QgsPalLayerSettings::SymbolLeftRight
Place direction symbols on left/right of label.
Definition: qgspallabeling.h:219
QgsGuiUtils::restoreGeometry
bool restoreGeometry(QWidget *widget, const QString &keyName)
Restore the wigget geometry from settings.
Definition: qgsguiutils.cpp:212
QgsTextBackgroundSettings::setBlendMode
void setBlendMode(QPainter::CompositionMode mode)
Sets the blending mode used for drawing the background shape.
Definition: qgstextrenderer.cpp:536
QgsSettings::setValue
void setValue(const QString &key, const QVariant &value, const QgsSettings::Section section=QgsSettings::NoSection)
Sets the value of setting key to value.
Definition: qgssettings.cpp:277
QgsTextShadowSettings::offsetMapUnitScale
QgsMapUnitScale offsetMapUnitScale() const
Returns the map unit scale object for the shadow offset distance.
Definition: qgstextrenderer.cpp:976
QgsTextFormat::blendMode
QPainter::CompositionMode blendMode() const
Returns the blending mode used for drawing the text.
Definition: qgstextrenderer.cpp:1351
QgsPropertyOverrideButton
A button for controlling property overrides which may apply to a widget.
Definition: qgspropertyoverridebutton.h:49
QgsTextShadowSettings::color
QColor color() const
Returns the color of the drop shadow.
Definition: qgstextrenderer.cpp:1056
QgsTextFormat::setSize
void setSize(double size)
Sets the size for rendered text.
Definition: qgstextrenderer.cpp:1326
QgsTextShadowSettings::setOffsetDistance
void setOffsetDistance(double distance)
Sets the distance for offsetting the position of the shadow from the text.
Definition: qgstextrenderer.cpp:961
QgsTextFormatWidget::widgetChanged
void widgetChanged()
Emitted when the text format defined by the widget changes.
QgsPaintEffectRegistry::defaultStack
static QgsPaintEffect * defaultStack()
Returns a new effect stack consisting of a sensible selection of default effects. ...
Definition: qgspainteffectregistry.cpp:113
QgsTextShadowSettings::blurRadiusMapUnitScale
QgsMapUnitScale blurRadiusMapUnitScale() const
Returns the map unit scale object for the shadow blur radius.
Definition: qgstextrenderer.cpp:1016
QgsPalLayerSettings::FromPoint
Offset distance applies from point geometry.
Definition: qgspallabeling.h:174
QgsTextFormatWidget::Text
Default mode, show text formatting settings only.
Definition: qgstextformatwidget.h:89
QgsTextBufferSettings::fillBufferInterior
bool fillBufferInterior() const
Returns whether the interior of the buffer will be filled in.
Definition: qgstextrenderer.cpp:137
QgsPanelWidget::findParentPanel
static QgsPanelWidget * findParentPanel(QWidget *widget)
Traces through the parents of a widget to find if it is contained within a QgsPanelWidget widget...
Definition: qgspanelwidget.cpp:48
QgsTextBackgroundSettings::setOffsetMapUnitScale
void setOffsetMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale object for the shape offset.
Definition: qgstextrenderer.cpp:486
QgsTextShadowSettings::setBlurAlphaOnly
void setBlurAlphaOnly(bool alphaOnly)
Sets whether only the alpha channel for the shadow should be blurred.
Definition: qgstextrenderer.cpp:1031
QgsTextBackgroundSettings::rotationType
RotationType rotationType() const
Returns the method used for rotating the background shape.
Definition: qgstextrenderer.cpp:441
QgsTextBufferSettings::setSizeMapUnitScale
void setSizeMapUnitScale(const QgsMapUnitScale &scale)
Sets the map unit scale object for the buffer size.
Definition: qgstextrenderer.cpp:122
QgsMapSettings::scale
double scale() const
Returns the calculated map scale.
Definition: qgsmapsettings.cpp:366
QgsPalLayerSettings::ShowAll
Show upside down for all labels, including dynamic ones.
Definition: qgspallabeling.h:214
QgsTextBackgroundSettings::paintEffect
QgsPaintEffect * paintEffect() const
Returns the current paint effect for the background shape.
Definition: qgstextrenderer.cpp:601
QgsTextShadowSettings::setBlendMode
void setBlendMode(QPainter::CompositionMode mode)
Sets the blending mode used for drawing the drop shadow.
Definition: qgstextrenderer.cpp:1071
QgsTextFormatWidget::enableDataDefinedAlignment
void enableDataDefinedAlignment(bool enable)
Controls whether data defined alignment buttons are enabled.
Definition: qgstextformatwidget.cpp:1431
QgsTextShadowSettings::setColor
void setColor(const QColor &color)
Sets the color for the drop shadow.
Definition: qgstextrenderer.cpp:1061
plugin_builder.f
f
Definition: plugin_builder.py:162
QgsUnitTypes::RenderInches
points (e.g., for font sizes)
Definition: qgsunittypes.h:107
QgsTextShadowSettings::setEnabled
void setEnabled(bool enabled)
Sets whether the text shadow will be drawn.
Definition: qgstextrenderer.cpp:931
QgsTextBufferSettings::setEnabled
void setEnabled(bool enabled)
Sets whether the text buffer will be drawn.
Definition: qgstextrenderer.cpp:92
QgsPalLayerSettings::AroundPoint
Arranges candidates in a circle around a point (or centroid of a polygon). Applies to point or polygo...
Definition: qgspallabeling.h:139
QgsTextFormat::setColor
void setColor(const QColor &color)
Sets the color that text will be rendered in.
Definition: qgstextrenderer.cpp:1336
QgsSubstitutionListWidget
A widget which allows users to specify a list of substitutions to apply to a string, with options for exporting and importing substitution lists.
Definition: qgssubstitutionlistwidget.h:36
QgsTextBackgroundSettings::radiiMapUnitScale
QgsMapUnitScale radiiMapUnitScale() const
Returns the map unit scale object for the shape radii.
Definition: qgstextrenderer.cpp:511
QgsTextBackgroundSettings::svgFile
QString svgFile() const
Returns the absolute path to the background SVG file, if set.
Definition: qgstextrenderer.cpp:391
QgsTextBackgroundSettings::joinStyle
Qt::PenJoinStyle joinStyle() const
Returns the join style used for drawing the background shape.
Definition: qgstextrenderer.cpp:591
QgsTextFormat::setNamedStyle
void setNamedStyle(const QString &style)
Sets the named style for the font used for rendering text.
Definition: qgstextrenderer.cpp:1295
QgsTextFormat::background
QgsTextBackgroundSettings & background()
Returns a reference to the text background settings.
Definition: qgstextrenderer.h:1017
QgsTextFormat::buffer
QgsTextBufferSettings & buffer()
Returns a reference to the text buffer settings.
Definition: qgstextrenderer.h:998
QgsTextFormat::setSizeUnit
void setSizeUnit(QgsUnitTypes::RenderUnit unit)
Sets the units for the size of rendered text.
Definition: qgstextrenderer.cpp:1306
QgsPalLayerSettings::Upright
Upside-down labels (90 <= angle < 270) are shown upright.
Definition: qgspallabeling.h:212
QgsTextBackgroundSettings::SizeType
SizeType
Methods for determining the background shape size.
Definition: qgstextrenderer.h:261
QgsTextBufferSettings::opacity
double opacity() const
Returns the buffer opacity.
Definition: qgstextrenderer.cpp:147
QgsTextFormatWidget::updateLinePlacementOptions
void updateLinePlacementOptions()
Updates line placement options to reflect current state of widget.
Definition: qgstextformatwidget.cpp:1215
QgsSvgSelectorWidget::setSvgPath
void setSvgPath(const QString &svgPath)
Accepts absolute paths.
Definition: qgssvgselectorwidget.cpp:391
QgsTextBackgroundSettings::setSize
void setSize(QSizeF size)
Sets the size of the background shape.
Definition: qgstextrenderer.cpp:416
QgsTextFormatWidget::mSubstitutions
QgsStringReplacementCollection mSubstitutions
Text substitution list.
Definition: qgstextformatwidget.h:120
QgsCollapsibleGroupBox::setSettingGroup
void setSettingGroup(const QString &group)
Set this to a defined string to share save/restore states across different parent dialogs...
Definition: qgscollapsiblegroupbox.h:217
QgsTextBackgroundSettings::setRadii
void setRadii(QSizeF radii)
Sets the radii used for rounding the corners of shapes.
Definition: qgstextrenderer.cpp:496
QgsTextFormatWidget::setPreviewBackground
void setPreviewBackground(const QColor &color)
Sets the background color for the text preview widget.
Definition: qgstextformatwidget.cpp:920
QgsPanelWidget::widgetChanged
void widgetChanged()
Emitted when the widget state changes.
QgsTextBackgroundSettings::strokeWidthUnit
QgsUnitTypes::RenderUnit strokeWidthUnit() const
Returns the units used for the shape&#39;s stroke width.
Definition: qgstextrenderer.cpp:571
QgsPalLayerSettings::FromSymbolBounds
Offset distance applies from rendered symbol bounds.
Definition: qgspallabeling.h:175
QgsTextBackgroundSettings::setSizeType
void setSizeType(SizeType type)
Sets the method used to determine the size of the background shape (e.g., fixed size or buffer around...
Definition: qgstextrenderer.cpp:406
QgsCharacterSelectorDialog::selectCharacter
const QChar & selectCharacter(bool *gotChar, const QFont &font, const QString &style)
Definition: qgscharacterselectordialog.cpp:31
QgsTextBackgroundSettings::setType
void setType(ShapeType type)
Sets the type of background shape to draw (e.g., square, ellipse, SVG).
Definition: qgstextrenderer.cpp:386
QgsPalLayerSettings::SymbolAbove
Place direction symbols on above label.
Definition: qgspallabeling.h:220
QgsTextBackgroundSettings::blendMode
QPainter::CompositionMode blendMode() const
Returns the blending mode used for drawing the background shape.
Definition: qgstextrenderer.cpp:531
QgsTextFormatWidget::format
QgsTextFormat format() const
Returns the current formatting settings defined by the widget.
QgsSvgCache::containsParams
void containsParams(const QString &path, bool &hasFillParam, QColor &defaultFillColor, bool &hasStrokeParam, QColor &defaultStrokeColor, bool &hasStrokeWidthParam, double &defaultStrokeWidth) const
Tests if an svg file contains parameters for fill, stroke color, stroke width.
Definition: qgssvgcache.cpp:239
QgsTextBackgroundSettings::offsetUnit
QgsUnitTypes::RenderUnit offsetUnit() const
Returns the units used for the shape&#39;s offset.
Definition: qgstextrenderer.cpp:471
QgsTextBackgroundSettings::rotation
double rotation() const
Returns the rotation for the background shape, in degrees clockwise.
Definition: qgstextrenderer.cpp:451
QgsTextFormat::lineHeight
double lineHeight() const
Returns the line height for text.
Definition: qgstextrenderer.cpp:1361
QgsTextFormatWidget::mPlaceLineBtnGrp
QButtonGroup * mPlaceLineBtnGrp
Line placement button group.
Definition: qgstextformatwidget.h:130
QgsTextBackgroundSettings::setEnabled
void setEnabled(bool enabled)
Sets whether the text background will be drawn.
Definition: qgstextrenderer.cpp:376
QgsMapCanvas::mapSettings
const QgsMapSettings & mapSettings() const
Get access to properties used for map rendering.
Definition: qgsmapcanvas.cpp:363
QgsTextShadowSettings::offsetAngle
int offsetAngle() const
Returns the angle for offsetting the position of the shadow from the text.
Definition: qgstextrenderer.cpp:946
QgsTextBackgroundSettings::ShapeType
ShapeType
Background shape types.
Definition: qgstextrenderer.h:249
QgsSubstitutionListWidget::substitutionsChanged
void substitutionsChanged(const QgsStringReplacementCollection &substitutions)
Emitted when the substitution definitions change.
QgsColorButton::colorChanged
void colorChanged(const QColor &color)
Is emitted whenever a new color is set for the button.
QgsSvgSelectorDialog::svgSelector
QgsSvgSelectorWidget * svgSelector()
Returns pointer to the embedded SVG selector widget.
Definition: qgssvgselectorwidget.h:311
QgsPalLayerSettings::Line
Arranges candidates over a point (or centroid of a polygon), or at a preset offset from the point...
Definition: qgspallabeling.h:141
QgsTextFormatPanelWidget::format
QgsTextFormat format() const
Returns the current formatting settings defined by the widget.
Definition: qgstextformatwidget.cpp:1482
whileBlocking
QgsSignalBlocker< Object > whileBlocking(Object *object)
Temporarily blocks signals from a QObject while calling a single method from the object.
Definition: qgis.h:224
QgsFontUtils::fontFamilyMatchOnSystem
static bool fontFamilyMatchOnSystem(const QString &family, QString *chosen=nullptr, bool *match=nullptr)
Check whether font family is on system.
Definition: qgsfontutils.cpp:68
QgsTextFormat::sizeMapUnitScale
QgsMapUnitScale sizeMapUnitScale() const
Returns the map unit scale object for the size.
Definition: qgstextrenderer.cpp:1311
QgsTextBufferSettings::sizeUnit
QgsUnitTypes::RenderUnit sizeUnit() const
Returns the units for the buffer size.
Definition: qgstextrenderer.cpp:107
QgsTextShadowSettings::offsetUnit
QgsUnitTypes::RenderUnit offsetUnit() const
Returns the units used for the shadow&#39;s offset.
Definition: qgstextrenderer.cpp:966
QgsTextShadowSettings::enabled
bool enabled() const
Returns whether the shadow is enabled.
Definition: qgstextrenderer.cpp:926
QgsTextFormatWidget::QgsTextFormatWidget
QgsTextFormatWidget(const QgsTextFormat &format=QgsTextFormat(), QgsMapCanvas *mapCanvas=nullptr, QWidget *parent=nullptr)
Constructor for QgsTextFormatWidget.
Definition: qgstextformatwidget.cpp:34
QgsTextFormatWidget::mPlacePolygonBtnGrp
QButtonGroup * mPlacePolygonBtnGrp
Polygon placement button group.
Definition: qgstextformatwidget.h:132
QgsEffectStackCompactWidget::changed
void changed()
Emitted when the paint effect properties change.
QgsTextShadowSettings
Container for settings relating to a text shadow.
Definition: qgstextrenderer.h:697
QgsStringReplacementCollection
A collection of string replacements (specified using QgsStringReplacement objects).
Definition: qgsstringutils.h:112
QgsTextShadowSettings::offsetGlobal
bool offsetGlobal() const
Returns true if the global shadow offset will be used.
Definition: qgstextrenderer.cpp:986
QgsTextBufferSettings::color
QColor color() const
Returns the color of the buffer.
Definition: qgstextrenderer.cpp:127
QgsTextBufferSettings::size
double size() const
Returns the size of the buffer.
Definition: qgstextrenderer.cpp:97
QgsTextBackgroundSettings::radiiUnit
QgsUnitTypes::RenderUnit radiiUnit() const
Returns the units used for the shape&#39;s radii.
Definition: qgstextrenderer.cpp:501
QgsSettings::value
QVariant value(const QString &key, const QVariant &defaultValue=QVariant(), const Section section=NoSection) const
Returns the value for setting key.
Definition: qgssettings.cpp:164
QgsTextBufferSettings
Container for settings relating to a text buffer.
Definition: qgstextrenderer.h:46
QgsTextBackgroundSettings::setFillColor
void setFillColor(const QColor &color)
Sets the color used for filing the background shape.
Definition: qgstextrenderer.cpp:546
QgsFontUtils::updateFontViaStyle
static bool updateFontViaStyle(QFont &f, const QString &fontstyle, bool fallback=false)
Updates font with named style and retain all font properties.
Definition: qgsfontutils.cpp:121
QgsProject::instance
static QgsProject * instance()
Returns the QgsProject singleton instance.
Definition: qgsproject.cpp:383
QgsTextFormat::size
double size() const
Returns the size for rendered text.
Definition: qgstextrenderer.cpp:1321
QgsTextBackgroundSettings::setStrokeWidthUnit
void setStrokeWidthUnit(QgsUnitTypes::RenderUnit units)
Sets the units used for the shape&#39;s stroke width.
Definition: qgstextrenderer.cpp:576
QgsTextBackgroundSettings::enabled
bool enabled() const
Returns whether the background is enabled.
Definition: qgstextrenderer.cpp:371
QgsTextFormatWidget::mMinPixelLimit
int mMinPixelLimit
Pixel size font limit.
Definition: qgstextformatwidget.h:134
QgsTextBackgroundSettings::sizeType
SizeType sizeType() const
Returns the method used to determine the size of the background shape (e.g., fixed size or buffer aro...
Definition: qgstextrenderer.cpp:401
QgsSubstitutionListDialog::setSubstitutions
void setSubstitutions(const QgsStringReplacementCollection &substitutions)
Sets the list of substitutions to show in the dialog.
Definition: qgssubstitutionlistwidget.cpp:226
QgsTextShadowSettings::blurRadiusUnit
QgsUnitTypes::RenderUnit blurRadiusUnit() const
Returns the units used for the shadow&#39;s blur radius.
Definition: qgstextrenderer.cpp:1006
QgsTextBufferSettings::enabled
bool enabled() const
Returns whether the buffer is enabled.
Definition: qgstextrenderer.cpp:87
QgsTextShadowSettings::scale
int scale() const
Returns the scaling used for the drop shadow (in percentage of original size).
Definition: qgstextrenderer.cpp:1046
QgsTextBackgroundSettings::RotationSync
Shape rotation is synced with text rotation.
Definition: qgstextrenderer.h:273
QgsTextFormatWidget::mQuadrantBtnGrp
QButtonGroup * mQuadrantBtnGrp
Quadrant button group.
Definition: qgstextformatwidget.h:122
QgsTextShadowSettings::setShadowPlacement
void setShadowPlacement(QgsTextShadowSettings::ShadowPlacement placement)
Sets the placement for the drop shadow.
Definition: qgstextrenderer.cpp:941
QgsTextFormat::setBlendMode
void setBlendMode(QPainter::CompositionMode mode)
Sets the blending mode used for drawing the text.
Definition: qgstextrenderer.cpp:1356
QgsTextFormat::setBuffer
void setBuffer(const QgsTextBufferSettings &bufferSettings)
Sets the text&#39;s buffer settings.
Definition: qgstextrenderer.h:1011
QgsTextFormat::setShadow
void setShadow(const QgsTextShadowSettings &shadowSettings)
Sets the text&#39;s drop shadow settings.
Definition: qgstextrenderer.h:1049
QgsSubstitutionListDialog
A dialog which allows users to specify a list of substitutions to apply to a string, with options for exporting and importing substitution lists.
Definition: qgssubstitutionlistwidget.h:89
QgsTextBufferSettings::paintEffect
QgsPaintEffect * paintEffect() const
Returns the current paint effect for the buffer.
Definition: qgstextrenderer.cpp:177
QgsTextBackgroundSettings::sizeMapUnitScale
QgsMapUnitScale sizeMapUnitScale() const
Returns the map unit scale object for the shape size.
Definition: qgstextrenderer.cpp:431
QgsUnitSelectionWidget::setMapCanvas
void setMapCanvas(QgsMapCanvas *canvas)
Sets the map canvas associated with the widget.
Definition: qgsunitselectionwidget.cpp:218
QgsPalLayerSettings::ShowDefined
Show upside down when rotation is layer- or data-defined.
Definition: qgspallabeling.h:213
QgsTextFormatWidget::updatePlacementWidgets
void updatePlacementWidgets()
Updates label placement options to reflect current state of widget.
Definition: qgstextformatwidget.cpp:933
QgsTextFormat
Container for all settings relating to text rendering.
Definition: qgstextrenderer.h:978
QgsTextFormat::sizeUnit
QgsUnitTypes::RenderUnit sizeUnit() const
Returns the units for the size of rendered text.
Definition: qgstextrenderer.cpp:1301
QgsTextBufferSettings::setBlendMode
void setBlendMode(QPainter::CompositionMode mode)
Sets the blending mode used for drawing the buffer.
Definition: qgstextrenderer.cpp:172
QgsUnitSelectionWidget
A widget displaying a combobox allowing the user to choose between various display units...
Definition: qgsunitselectionwidget.h:158
QgsTextBackgroundSettings::setSvgFile
void setSvgFile(const QString &file)
Sets the path to the background SVG file.
Definition: qgstextrenderer.cpp:396
QgsTextShadowSettings::blurAlphaOnly
bool blurAlphaOnly() const
Returns whether only the alpha channel for the shadow will be blurred.
Definition: qgstextrenderer.cpp:1026
QgsTextShadowSettings::setOffsetGlobal
void setOffsetGlobal(bool global)
Sets whether the global shadow offset should be used.
Definition: qgstextrenderer.cpp:991
QgsTextFormatWidget::mPlacePointBtnGrp
QButtonGroup * mPlacePointBtnGrp
Point placement button group.
Definition: qgstextformatwidget.h:128
QgsTextBufferSettings::setOpacity
void setOpacity(double opacity)
Sets the buffer opacity.
Definition: qgstextrenderer.cpp:152
QgsTextBackgroundSettings::ShapeSquare
Square - buffered sizes only.
Definition: qgstextrenderer.h:252
QgsPanelWidgetWrapper
Wrapper widget for existing widgets which can&#39;t have the inheritance tree changed, e.g dialogs.
Definition: qgspanelwidget.h:181
QgsSubstitutionListDialog::substitutions
QgsStringReplacementCollection substitutions
Definition: qgssubstitutionlistwidget.h:92
QgsPanelWidget::setPanelTitle
void setPanelTitle(const QString &panelTitle)
Set the title of the panel when shown in the interface.
Definition: qgspanelwidget.h:42
QgsTextFormatPanelWidget::QgsTextFormatPanelWidget
QgsTextFormatPanelWidget(const QgsTextFormat &format, QgsMapCanvas *mapCanvas=nullptr, QWidget *parent=nullptr)
Constructor for QgsTextFormatPanelWidget.
Definition: qgstextformatwidget.cpp:1475
QgsTextFormat::namedStyle
QString namedStyle() const
Returns the named style for the font used for rendering text (e.g., "bold").
Definition: qgstextrenderer.cpp:1286
QgsTextFormat::font
QFont font() const
Returns the font used for rendering text.
Definition: qgstextrenderer.cpp:1267
QgsTextBackgroundSettings::setRotationType
void setRotationType(RotationType type)
Sets the method used for rotating the background shape.
Definition: qgstextrenderer.cpp:446
QgsTextBufferSettings::setColor
void setColor(const QColor &color)
Sets the color for the buffer.
Definition: qgstextrenderer.cpp:132
QgsTextBackgroundSettings::sizeUnit
QgsUnitTypes::RenderUnit sizeUnit() const
Returns the units used for the shape&#39;s size.
Definition: qgstextrenderer.cpp:421
QgsTextFormatWidget::mDirectSymbBtnGrp
QButtonGroup * mDirectSymbBtnGrp
Symbol direction button group.
Definition: qgstextformatwidget.h:124
QgsTextShadowSettings::opacity
double opacity() const
Returns the shadow&#39;s opacity.
Definition: qgstextrenderer.cpp:1036
QgsTextBackgroundSettings::setOpacity
void setOpacity(double opacity)
Sets the background shape&#39;s opacity.
Definition: qgstextrenderer.cpp:526
QgsTextBackgroundSettings::setPaintEffect
void setPaintEffect(QgsPaintEffect *effect)
Sets the current paint effect for the background shape.
Definition: qgstextrenderer.cpp:606
QgsTextFormat::resolvedFontFamily
QString resolvedFontFamily() const
Returns the family for the resolved font, ie if the specified font was not found on the system this w...
Definition: qgstextrenderer.h:1253
QgsTextFormatDialog::QgsTextFormatDialog
QgsTextFormatDialog(const QgsTextFormat &format, QgsMapCanvas *mapCanvas=nullptr, QWidget *parent=nullptr, Qt::WindowFlags fl=QgsGuiUtils::ModalDialogFlags)
Constructor for QgsTextFormatDialog.
Definition: qgstextformatwidget.cpp:1441
QgsTextShadowSettings::setOffsetAngle
void setOffsetAngle(int angle)
Sets the angle for offsetting the position of the shadow from the text.
Definition: qgstextrenderer.cpp:951
QgsPalLayerSettings::Free
Arranges candidates scattered throughout a polygon feature. Candidates are rotated to respect the pol...
Definition: qgspallabeling.h:144
QgsTextBackgroundSettings::setRotation
void setRotation(double rotation)
Sets the rotation for the background shape, in degrees clockwise.
Definition: qgstextrenderer.cpp:456
QgsOpacityWidget
A widget for setting an opacity value.
Definition: qgsopacitywidget.h:32
Generated on Sat Apr 21 2018 11:45:00 for QGIS API Documentation by   doxygen 1.8.13