QGIS API Documentation  3.26.3-Buenos Aires (65e4edfdad)
qgslayoutmarkerwidget.cpp
Go to the documentation of this file.
1 /***************************************************************************
2  qgslayoutmarkerwidget.cpp
3  --------------------------
4  begin : April 2020
5  copyright : (C) 2020 by Nyall Dawson
6  email : nyall dot dawson at gmail dot com
7  ***************************************************************************/
8 
9 /***************************************************************************
10  * *
11  * This program is free software; you can redistribute it and/or modify *
12  * it under the terms of the GNU General Public License as published by *
13  * the Free Software Foundation; either version 2 of the License, or *
14  * (at your option) any later version. *
15  * *
16  ***************************************************************************/
17 
18 #include "qgslayoutmarkerwidget.h"
19 #include "qgsstyle.h"
20 #include "qgslayoutitemmarker.h"
21 #include "qgslayout.h"
22 #include "qgslayoutundostack.h"
23 #include "qgsvectorlayer.h"
24 #include "qgslayoutitemmap.h"
25 #include "qgsmarkersymbol.h"
26 
28  : QgsLayoutItemBaseWidget( nullptr, marker )
29  , mMarker( marker )
30 {
31  Q_ASSERT( mMarker );
32 
33  setupUi( this );
34  setPanelTitle( tr( "Marker Properties" ) );
35 
36  //add widget for general composer item properties
37  mItemPropertiesWidget = new QgsLayoutItemPropertiesWidget( this, marker );
38  mItemPropertiesWidget->showFrameGroup( false );
39  mainLayout->addWidget( mItemPropertiesWidget );
40 
41  blockAllSignals( true );
42 
43  mShapeStyleButton->setSymbolType( Qgis::SymbolType::Marker );
44 
45  blockAllSignals( false );
46 
47  connect( mMarker, &QgsLayoutObject::changed, this, &QgsLayoutMarkerWidget::setGuiElementValues );
48  mShapeStyleButton->registerExpressionContextGenerator( mMarker );
49 
50  connect( mShapeStyleButton, &QgsSymbolButton::changed, this, &QgsLayoutMarkerWidget::symbolChanged );
51 
52  connect( mRotationFromMapCheckBox, &QCheckBox::stateChanged, this, &QgsLayoutMarkerWidget::rotationFromMapCheckBoxChanged );
53  connect( mNorthOffsetSpinBox, static_cast < void ( QDoubleSpinBox::* )( double ) > ( &QDoubleSpinBox::valueChanged ), this, &QgsLayoutMarkerWidget::northOffsetSpinBoxChanged );
54  connect( mNorthTypeComboBox, static_cast<void ( QComboBox::* )( int )>( &QComboBox::currentIndexChanged ), this, &QgsLayoutMarkerWidget::northTypeComboBoxChanged );
55 
56  mNorthTypeComboBox->blockSignals( true );
57  mNorthTypeComboBox->addItem( tr( "Grid North" ), QgsLayoutNorthArrowHandler::GridNorth );
58  mNorthTypeComboBox->addItem( tr( "True North" ), QgsLayoutNorthArrowHandler::TrueNorth );
59  mNorthTypeComboBox->blockSignals( false );
60  mNorthOffsetSpinBox->setClearValue( 0.0 );
61 
62  mShapeStyleButton->setLayer( coverageLayer() );
63  if ( mMarker->layout() )
64  {
65  connect( &mMarker->layout()->reportContext(), &QgsLayoutReportContext::layerChanged, mShapeStyleButton, &QgsSymbolButton::setLayer );
66  mMapComboBox->setCurrentLayout( mMarker->layout() );
67  mMapComboBox->setItemType( QgsLayoutItemRegistry::LayoutMap );
68  connect( mMapComboBox, &QgsLayoutItemComboBox::itemChanged, this, &QgsLayoutMarkerWidget::mapChanged );
69  }
70 
71  setGuiElementValues();
72 }
73 
75 {
76  if ( mItemPropertiesWidget )
77  mItemPropertiesWidget->setMasterLayout( masterLayout );
78 }
79 
81 {
83  return false;
84 
85  if ( mMarker )
86  {
87  disconnect( mMarker, &QgsLayoutObject::changed, this, &QgsLayoutMarkerWidget::setGuiElementValues );
88  }
89 
90  mMarker = qobject_cast< QgsLayoutItemMarker * >( item );
91  mItemPropertiesWidget->setItem( mMarker );
92 
93  if ( mMarker )
94  {
95  connect( mMarker, &QgsLayoutObject::changed, this, &QgsLayoutMarkerWidget::setGuiElementValues );
96  mShapeStyleButton->registerExpressionContextGenerator( mMarker );
97  }
98 
99  setGuiElementValues();
100 
101  return true;
102 }
103 
104 void QgsLayoutMarkerWidget::blockAllSignals( bool block )
105 {
106  mShapeStyleButton->blockSignals( block );
107  mMapComboBox->blockSignals( block );
108  mRotationFromMapCheckBox->blockSignals( block );
109  mNorthTypeComboBox->blockSignals( block );
110  mNorthOffsetSpinBox->blockSignals( block );
111 }
112 
113 void QgsLayoutMarkerWidget::setGuiElementValues()
114 {
115  if ( !mMarker )
116  {
117  return;
118  }
119 
120  blockAllSignals( true );
121 
122  mShapeStyleButton->setSymbol( mMarker->symbol()->clone() );
123 
124  mMapComboBox->setItem( mMarker->linkedMap() );
125  if ( mMarker->linkedMap() )
126  {
127  mRotationFromMapCheckBox->setCheckState( Qt::Checked );
128  mMapComboBox->setEnabled( true );
129  mNorthTypeComboBox->setEnabled( true );
130  mNorthOffsetSpinBox->setEnabled( true );
131  }
132  else
133  {
134  mRotationFromMapCheckBox->setCheckState( Qt::Unchecked );
135  mMapComboBox->setEnabled( false );
136  mNorthTypeComboBox->setEnabled( false );
137  mNorthOffsetSpinBox->setEnabled( false );
138  }
139  mNorthTypeComboBox->setCurrentIndex( mNorthTypeComboBox->findData( mMarker->northMode() ) );
140  mNorthOffsetSpinBox->setValue( mMarker->northOffset() );
141 
142  blockAllSignals( false );
143 }
144 
145 void QgsLayoutMarkerWidget::symbolChanged()
146 {
147  if ( !mMarker )
148  return;
149 
150  mMarker->layout()->undoStack()->beginCommand( mMarker, tr( "Change Marker Symbol" ), QgsLayoutItem::UndoShapeStyle );
151  mMarker->setSymbol( mShapeStyleButton->clonedSymbol<QgsMarkerSymbol>() );
152  mMarker->layout()->undoStack()->endCommand();
153 }
154 
155 void QgsLayoutMarkerWidget::rotationFromMapCheckBoxChanged( int state )
156 {
157  if ( !mMarker )
158  {
159  return;
160  }
161 
162  mMarker->beginCommand( tr( "Toggle Rotation Sync" ) );
163  if ( state == Qt::Unchecked )
164  {
165  mMarker->setLinkedMap( nullptr );
166  mMapComboBox->setEnabled( false );
167  mNorthTypeComboBox->setEnabled( false );
168  mNorthOffsetSpinBox->setEnabled( false );
169  }
170  else
171  {
172  QgsLayoutItemMap *map = qobject_cast< QgsLayoutItemMap * >( mMapComboBox->currentItem() );
173  mMarker->setLinkedMap( map );
174  mNorthTypeComboBox->setEnabled( true );
175  mNorthOffsetSpinBox->setEnabled( true );
176  mMapComboBox->setEnabled( true );
177  }
178  mMarker->endCommand();
179 }
180 
181 void QgsLayoutMarkerWidget::mapChanged( QgsLayoutItem *item )
182 {
183  if ( !mMarker )
184  {
185  return;
186  }
187 
188  const QgsLayout *layout = mMarker->layout();
189  if ( !layout )
190  {
191  return;
192  }
193 
194  QgsLayoutItemMap *map = qobject_cast< QgsLayoutItemMap *>( item );
195  if ( !map )
196  {
197  return;
198  }
199 
200  mMarker->beginCommand( tr( "Change Rotation Map" ) );
201  mMarker->setLinkedMap( map );
202  mMarker->update();
203  mMarker->endCommand();
204 }
205 
206 void QgsLayoutMarkerWidget::northOffsetSpinBoxChanged( double d )
207 {
208  mMarker->beginCommand( tr( "Change Marker North Offset" ), QgsLayoutItem::UndoPictureNorthOffset );
209  mMarker->setNorthOffset( d );
210  mMarker->endCommand();
211  mMarker->update();
212 }
213 
214 void QgsLayoutMarkerWidget::northTypeComboBoxChanged( int index )
215 {
216  mMarker->beginCommand( tr( "Change Marker North Mode" ) );
217  mMarker->setNorthMode( static_cast< QgsLayoutNorthArrowHandler::NorthMode >( mNorthTypeComboBox->itemData( index ).toInt() ) );
218  mMarker->endCommand();
219  mMarker->update();
220 }
QgsSymbolButton::changed
void changed()
Emitted when the symbol's settings are changed.
qgslayoutundostack.h
QgsLayoutItemMarker
A layout item for showing marker symbols.
Definition: qgslayoutitemmarker.h:33
QgsLayoutItem::UndoShapeStyle
@ UndoShapeStyle
Shape symbol style.
Definition: qgslayoutitem.h:226
QgsLayoutItem::UndoPictureNorthOffset
@ UndoPictureNorthOffset
Picture north offset.
Definition: qgslayoutitem.h:246
QgsLayoutNorthArrowHandler::TrueNorth
@ TrueNorth
Align to true north.
Definition: qgslayoutnortharrowhandler.h:41
QgsLayoutObject::changed
void changed()
Emitted when the object's properties change.
qgslayoutmarkerwidget.h
QgsLayoutItemPropertiesWidget
A widget for controlling the common properties of layout items (e.g. position and size,...
Definition: qgslayoutitemwidget.h:217
QgsLayoutItemBaseWidget::coverageLayer
QgsVectorLayer * coverageLayer() const
Returns the current layout context coverage layer (if set).
Definition: qgslayoutitemwidget.cpp:256
QgsLayoutItemPropertiesWidget::showFrameGroup
void showFrameGroup(bool showGroup)
Determines if the frame of the group box shall be shown.
Definition: qgslayoutitemwidget.cpp:396
QgsLayoutItemPropertiesWidget::setMasterLayout
void setMasterLayout(QgsMasterLayoutInterface *masterLayout)
Sets the master layout associated with the item.
Definition: qgslayoutitemwidget.cpp:420
QgsLayoutItem::type
int type() const override
Returns a unique graphics item type identifier.
Definition: qgslayoutitem.cpp:124
QgsLayoutMarkerWidget::setNewItem
bool setNewItem(QgsLayoutItem *item) override
Attempts to update the widget to show the properties for the specified item.
Definition: qgslayoutmarkerwidget.cpp:80
QgsLayoutMarkerWidget::QgsLayoutMarkerWidget
QgsLayoutMarkerWidget(QgsLayoutItemMarker *marker)
constructor
Definition: qgslayoutmarkerwidget.cpp:27
QgsMarkerSymbol
A marker symbol type, for rendering Point and MultiPoint geometries.
Definition: qgsmarkersymbol.h:30
QgsLayoutItem
Base class for graphical items within a QgsLayout.
Definition: qgslayoutitem.h:112
qgslayoutitemmarker.h
QgsPanelWidget::setPanelTitle
void setPanelTitle(const QString &panelTitle)
Set the title of the panel when shown in the interface.
Definition: qgspanelwidget.h:44
qgslayout.h
qgsstyle.h
QgsLayoutItemBaseWidget
A base class for property widgets for layout items. All layout item widgets should inherit from this ...
Definition: qgslayoutitemwidget.h:122
qgsvectorlayer.h
QgsLayoutNorthArrowHandler::NorthMode
NorthMode
Method for syncing rotation to a map's North direction.
Definition: qgslayoutnortharrowhandler.h:38
QgsLayoutItemMap
Layout graphical items for displaying a map.
Definition: qgslayoutitemmap.h:317
QgsLayoutMarkerWidget::setMasterLayout
void setMasterLayout(QgsMasterLayoutInterface *masterLayout) override
Sets the master layout associated with the item.
Definition: qgslayoutmarkerwidget.cpp:74
QgsSymbolButton::setLayer
void setLayer(QgsVectorLayer *layer)
Sets a layer to associate with the widget.
Definition: qgssymbolbutton.cpp:208
QgsLayout
Base class for layouts, which can contain items such as maps, labels, scalebars, etc.
Definition: qgslayout.h:50
qgsmarkersymbol.h
QgsLayoutItemRegistry::LayoutMap
@ LayoutMap
Map item.
Definition: qgslayoutitemregistry.h:347
QgsLayoutItemComboBox::itemChanged
void itemChanged(QgsLayoutItem *item)
Emitted whenever the currently selected item changes.
QgsMasterLayoutInterface
Interface for master layout type objects, such as print layouts and reports.
Definition: qgsmasterlayoutinterface.h:42
QgsLayoutItemRegistry::LayoutShape
@ LayoutShape
Shape item.
Definition: qgslayoutitemregistry.h:351
QgsLayoutItemPropertiesWidget::setItem
void setItem(QgsLayoutItem *item)
Sets the layout item.
Definition: qgslayoutitemwidget.cpp:401
QgsLayoutReportContext::layerChanged
void layerChanged(QgsVectorLayer *layer)
Emitted when the context's layer is changed.
Qgis::SymbolType::Marker
@ Marker
Marker symbol.
QgsLayoutNorthArrowHandler::GridNorth
@ GridNorth
Align to grid north.
Definition: qgslayoutnortharrowhandler.h:40
qgslayoutitemmap.h