QGIS API Documentation 3.32.0-Lima (311a8cb8a6)
qgslayoutpagepropertieswidget.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgslayoutpagepropertieswidget.cpp
3 ---------------------------------
4 Date : July 2017
5 Copyright : (C) 2017 Nyall Dawson
6 Email : nyall dot dawson at gmail dot com
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
17#include "qgsapplication.h"
18#include "qgspagesizeregistry.h"
19#include "qgslayoutitempage.h"
20#include "qgslayout.h"
22#include "qgslayoutundostack.h"
23#include "qgsvectorlayer.h"
24#include "qgsfillsymbol.h"
27
29 : QgsLayoutItemBaseWidget( parent, layoutItem )
30 , mPage( static_cast< QgsLayoutItemPage *>( layoutItem ) )
31{
32 setupUi( this );
33
34 mPageOrientationComboBox->addItem( tr( "Portrait" ), QgsLayoutItemPage::Portrait );
35 mPageOrientationComboBox->addItem( tr( "Landscape" ), QgsLayoutItemPage::Landscape );
36
37 const auto constEntries = QgsApplication::pageSizeRegistry()->entries();
38 for ( const QgsPageSize &size : constEntries )
39 {
40 mPageSizeComboBox->addItem( size.displayName, size.name );
41 }
42 mPageSizeComboBox->addItem( tr( "Custom" ) );
43
44 mWidthSpin->setValue( mPage->pageSize().width() );
45 mHeightSpin->setValue( mPage->pageSize().height() );
46 mSizeUnitsComboBox->setUnit( mPage->pageSize().units() );
47 mExcludePageCheckBox->setChecked( mPage->excludeFromExports() );
48
49 mPageOrientationComboBox->setCurrentIndex( mPageOrientationComboBox->findData( mPage->orientation() ) );
50
51 mSizeUnitsComboBox->linkToWidget( mWidthSpin );
52 mSizeUnitsComboBox->linkToWidget( mHeightSpin );
53 mSizeUnitsComboBox->setConverter( &mPage->layout()->renderContext().measurementConverter() );
54
55 mLockAspectRatio->setWidthSpinBox( mWidthSpin );
56 mLockAspectRatio->setHeightSpinBox( mHeightSpin );
57
58 mSymbolButton->setSymbolType( Qgis::SymbolType::Fill );
59 mSymbolButton->setSymbol( mPage->pageStyleSymbol()->clone() );
60
61 connect( mPageSizeComboBox, static_cast<void ( QComboBox::* )( int )>( &QComboBox::currentIndexChanged ), this, &QgsLayoutPagePropertiesWidget::pageSizeChanged );
62 connect( mPageOrientationComboBox, static_cast<void ( QComboBox::* )( int )>( &QComboBox::currentIndexChanged ), this, &QgsLayoutPagePropertiesWidget::orientationChanged );
63
64 connect( mWidthSpin, static_cast< void ( QDoubleSpinBox::* )( double )>( &QDoubleSpinBox::valueChanged ), this, &QgsLayoutPagePropertiesWidget::updatePageSize );
65 connect( mHeightSpin, static_cast< void ( QDoubleSpinBox::* )( double )>( &QDoubleSpinBox::valueChanged ), this, &QgsLayoutPagePropertiesWidget::updatePageSize );
66 connect( mWidthSpin, static_cast< void ( QDoubleSpinBox::* )( double )>( &QDoubleSpinBox::valueChanged ), this, &QgsLayoutPagePropertiesWidget::setToCustomSize );
67 connect( mHeightSpin, static_cast< void ( QDoubleSpinBox::* )( double )>( &QDoubleSpinBox::valueChanged ), this, &QgsLayoutPagePropertiesWidget::setToCustomSize );
68 connect( mExcludePageCheckBox, &QCheckBox::toggled, this, &QgsLayoutPagePropertiesWidget::excludeExportsToggled );
69
70 connect( mSymbolButton, &QgsSymbolButton::changed, this, &QgsLayoutPagePropertiesWidget::symbolChanged );
76
77 connect( mPaperSizeDDBtn, &QgsPropertyOverrideButton::changed, this, &QgsLayoutPagePropertiesWidget::refreshLayout );
78 connect( mWidthDDBtn, &QgsPropertyOverrideButton::changed, this, &QgsLayoutPagePropertiesWidget::refreshLayout );
79 connect( mHeightDDBtn, &QgsPropertyOverrideButton::changed, this, &QgsLayoutPagePropertiesWidget::refreshLayout );
80 connect( mOrientationDDBtn, &QgsPropertyOverrideButton::changed, this, &QgsLayoutPagePropertiesWidget::refreshLayout );
81
82 mExcludePageDDBtn->registerEnabledWidget( mExcludePageCheckBox, false );
83
84 mSymbolButton->registerExpressionContextGenerator( mPage );
85 mSymbolButton->setLayer( coverageLayer() );
86 if ( mPage->layout() )
87 {
89 }
90
91 showCurrentPageSize();
92}
93
94void QgsLayoutPagePropertiesWidget::pageSizeChanged( int )
95{
96 mBlockPageUpdate = true;
97 if ( mPageSizeComboBox->currentData().toString().isEmpty() )
98 {
99 //custom size
100 mLockAspectRatio->setEnabled( true );
101 mSizeUnitsComboBox->setEnabled( true );
102 mPageOrientationComboBox->setEnabled( false );
103 }
104 else
105 {
106 mLockAspectRatio->setEnabled( false );
107 mLockAspectRatio->setLocked( false );
108 mSizeUnitsComboBox->setEnabled( false );
109 mPageOrientationComboBox->setEnabled( true );
110 const QgsPageSize size = QgsApplication::pageSizeRegistry()->find( mPageSizeComboBox->currentData().toString() ).value( 0 );
111 const QgsLayoutSize convertedSize = mConverter.convert( size.size, mSizeUnitsComboBox->unit() );
112 mSettingPresetSize = true;
113 switch ( mPageOrientationComboBox->currentData().toInt() )
114 {
116 mWidthSpin->setValue( convertedSize.height() );
117 mHeightSpin->setValue( convertedSize.width() );
118 break;
119
121 mWidthSpin->setValue( convertedSize.width() );
122 mHeightSpin->setValue( convertedSize.height() );
123 break;
124 }
125 mSettingPresetSize = false;
126 }
127 mBlockPageUpdate = false;
128 updatePageSize();
129}
130
131void QgsLayoutPagePropertiesWidget::orientationChanged( int )
132{
133 if ( mPageSizeComboBox->currentData().toString().isEmpty() )
134 return;
135
136 const double width = mWidthSpin->value();
137 const double height = mHeightSpin->value();
138 switch ( mPageOrientationComboBox->currentData().toInt() )
139 {
141 if ( width < height )
142 {
143 whileBlocking( mWidthSpin )->setValue( height );
144 whileBlocking( mHeightSpin )->setValue( width );
145 }
146 break;
147
149 if ( width > height )
150 {
151 whileBlocking( mWidthSpin )->setValue( height );
152 whileBlocking( mHeightSpin )->setValue( width );
153 }
154 break;
155 }
156
157 updatePageSize();
158}
159
160void QgsLayoutPagePropertiesWidget::updatePageSize()
161{
162 if ( mBlockPageUpdate )
163 return;
164
165 mPage->layout()->undoStack()->beginMacro( tr( "Change Page Size" ) );
167 mPage->layout()->undoStack()->beginCommand( mPage, tr( "Change Page Size" ), 1 + mPage->layout()->pageCollection()->pageNumber( mPage ) );
168 mPage->setPageSize( QgsLayoutSize( mWidthSpin->value(), mHeightSpin->value(), mSizeUnitsComboBox->unit() ) );
169 mPage->layout()->undoStack()->endCommand();
170 mPage->layout()->pageCollection()->reflow();
172 mPage->layout()->undoStack()->endMacro();
173
174 refreshLayout();
176}
177
178void QgsLayoutPagePropertiesWidget::setToCustomSize()
179{
180 if ( mSettingPresetSize )
181 return;
182 whileBlocking( mPageSizeComboBox )->setCurrentIndex( mPageSizeComboBox->count() - 1 );
183 mPageOrientationComboBox->setEnabled( false );
184 pageSizeChanged( mPageSizeComboBox->currentIndex() );
185}
186
187void QgsLayoutPagePropertiesWidget::symbolChanged()
188{
189 mPage->layout()->undoStack()->beginCommand( mPage->layout()->pageCollection(), tr( "Change Page Background" ), QgsLayoutItemPage::UndoPageSymbol );
190 mPage->setPageStyleSymbol( static_cast< QgsFillSymbol * >( mSymbolButton->symbol() )->clone() );
191 mPage->layout()->undoStack()->endCommand();
192}
193
194void QgsLayoutPagePropertiesWidget::excludeExportsToggled( bool checked )
195{
196 mPage->beginCommand( !checked ? tr( "Include Page in Exports" ) : tr( "Exclude Page from Exports" ) );
197 mPage->setExcludeFromExports( checked );
198 mPage->endCommand();
199}
200
201void QgsLayoutPagePropertiesWidget::refreshLayout()
202{
203 mPage->layout()->refresh();
204}
205
206void QgsLayoutPagePropertiesWidget::showCurrentPageSize()
207{
208 const QgsLayoutSize paperSize = mPage->pageSize();
209 const QString pageSize = QgsApplication::pageSizeRegistry()->find( paperSize );
210 if ( !pageSize.isEmpty() )
211 {
212 whileBlocking( mPageSizeComboBox )->setCurrentIndex( mPageSizeComboBox->findData( pageSize ) );
213 mLockAspectRatio->setEnabled( false );
214 mLockAspectRatio->setLocked( false );
215 mSizeUnitsComboBox->setEnabled( false );
216 mPageOrientationComboBox->setEnabled( true );
217 }
218 else
219 {
220 // custom
221 whileBlocking( mPageSizeComboBox )->setCurrentIndex( mPageSizeComboBox->count() - 1 );
222 mLockAspectRatio->setEnabled( true );
223 mSizeUnitsComboBox->setEnabled( true );
224 mPageOrientationComboBox->setEnabled( false );
225 }
226}
@ Fill
Fill symbol.
static QgsPageSizeRegistry * pageSizeRegistry()
Returns the application's page size registry, used for managing layout page sizes.
A fill symbol type, for rendering Polygon and MultiPolygon geometries.
Definition: qgsfillsymbol.h:30
QgsFillSymbol * clone() const override
Returns a deep copy of this symbol.
A base class for property widgets for layout items.
QgsVectorLayer * coverageLayer() const
Returns the current layout context coverage layer (if set).
void registerDataDefinedButton(QgsPropertyOverrideButton *button, QgsLayoutObject::DataDefinedProperty property)
Registers a data defined button, setting up its initial value, connections and description.
Item representing the paper in a layout.
void setPageSize(const QgsLayoutSize &size)
Sets the size of the page.
QgsLayoutSize pageSize() const
Returns the size of the page.
const QgsFillSymbol * pageStyleSymbol() const
Returns the symbol to use for drawing the page background.
Orientation orientation() const
Returns the page orientation.
void setPageStyleSymbol(QgsFillSymbol *symbol)
Sets the symbol to use for drawing the page background.
@ Landscape
Landscape orientation.
@ Portrait
Portrait orientation.
@ UndoPageSymbol
Layout page symbol change.
Base class for graphical items within a QgsLayout.
bool excludeFromExports() const
Returns whether the item should be excluded from layout exports and prints.
void beginCommand(const QString &commandText, UndoCommand command=UndoNone)
Starts new undo command for this item.
void endCommand()
Completes the current item command and push it onto the layout's undo stack.
void setExcludeFromExports(bool exclude)
Sets whether the item should be excluded from layout exports and prints.
QgsLayoutMeasurement convert(QgsLayoutMeasurement measurement, Qgis::LayoutUnit targetUnits) const
Converts a measurement from one unit to another.
const QgsLayout * layout() const
Returns the layout the object is attached to.
@ PaperOrientation
Paper orientation.
@ ItemWidth
Width of item.
@ ItemHeight
Height of item.
@ ExcludeFromExports
Exclude item from exports.
@ PresetPaperSize
Preset paper size for composition.
void reflow()
Forces the page collection to reflow the arrangement of pages, e.g.
void endPageSizeChange()
Should be called after changing any page item sizes, and preceded by a call to beginPageSizeChange().
int pageNumber(QgsLayoutItemPage *page) const
Returns the page number for the specified page, or -1 if the page is not contained in the collection.
void beginPageSizeChange()
Should be called before changing any page item sizes, and followed by a call to endPageSizeChange().
QgsLayoutPagePropertiesWidget(QWidget *parent, QgsLayoutItem *page)
Constructor for QgsLayoutPagePropertiesWidget.
void pageOrientationChanged()
Emitted when page orientation changes.
const QgsLayoutMeasurementConverter & measurementConverter() const
Returns the layout measurement converter to be used in the layout.
void layerChanged(QgsVectorLayer *layer)
Emitted when the context's layer is changed.
This class provides a method of storing sizes, consisting of a width and height, for use in QGIS layo...
Definition: qgslayoutsize.h:41
double height() const
Returns the height of the size.
Definition: qgslayoutsize.h:90
Qgis::LayoutUnit units() const
Returns the units for the size.
double width() const
Returns the width of the size.
Definition: qgslayoutsize.h:76
void endCommand()
Saves final state of an object and pushes the active command to the undo history.
void beginMacro(const QString &commandText)
Starts a macro command, with the given descriptive commandText.
void beginCommand(QgsLayoutUndoObjectInterface *object, const QString &commandText, int id=0)
Begins a new undo command for the specified object.
void endMacro()
Ends a macro command.
QgsLayoutRenderContext & renderContext()
Returns a reference to the layout's render context, which stores information relating to the current ...
Definition: qgslayout.cpp:367
QgsLayoutPageCollection * pageCollection()
Returns a pointer to the layout's page collection, which stores and manages page items in the layout.
Definition: qgslayout.cpp:467
void refresh()
Forces the layout, and all items contained within it, to refresh.
Definition: qgslayout.cpp:813
QgsLayoutReportContext & reportContext()
Returns a reference to the layout's report context, which stores information relating to the current ...
Definition: qgslayout.cpp:377
QgsLayoutUndoStack * undoStack()
Returns a pointer to the layout's undo stack, which manages undo/redo states for the layout and it's ...
Definition: qgslayout.cpp:694
QList< QgsPageSize > entries() const
Returns a list of page sizes in the registry.
QList< QgsPageSize > find(const QString &name) const
Finds matching page sizes from the registry, using a case insensitive match on the page size name.
A named page size for layouts.
QgsLayoutSize size
Page size.
void changed()
Emitted when property definition changes.
void setLayer(QgsVectorLayer *layer)
Sets a layer to associate with the widget.
void changed()
Emitted when the symbol's settings are changed.
QgsSignalBlocker< Object > whileBlocking(Object *object)
Temporarily blocks signals from a QObject while calling a single method from the object.
Definition: qgis.h:3914