QGIS API Documentation 3.28.0-Firenze (ed3ad0430f)
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"
25
27 : QgsLayoutItemBaseWidget( parent, layoutItem )
28 , mPage( static_cast< QgsLayoutItemPage *>( layoutItem ) )
29{
30 setupUi( this );
31
32 mPageOrientationComboBox->addItem( tr( "Portrait" ), QgsLayoutItemPage::Portrait );
33 mPageOrientationComboBox->addItem( tr( "Landscape" ), QgsLayoutItemPage::Landscape );
34
35 const auto constEntries = QgsApplication::pageSizeRegistry()->entries();
36 for ( const QgsPageSize &size : constEntries )
37 {
38 mPageSizeComboBox->addItem( size.displayName, size.name );
39 }
40 mPageSizeComboBox->addItem( tr( "Custom" ) );
41
42 mWidthSpin->setValue( mPage->pageSize().width() );
43 mHeightSpin->setValue( mPage->pageSize().height() );
44 mSizeUnitsComboBox->setUnit( mPage->pageSize().units() );
45 mExcludePageCheckBox->setChecked( mPage->excludeFromExports() );
46
47 mPageOrientationComboBox->setCurrentIndex( mPageOrientationComboBox->findData( mPage->orientation() ) );
48
49 mSizeUnitsComboBox->linkToWidget( mWidthSpin );
50 mSizeUnitsComboBox->linkToWidget( mHeightSpin );
51 mSizeUnitsComboBox->setConverter( &mPage->layout()->renderContext().measurementConverter() );
52
53 mLockAspectRatio->setWidthSpinBox( mWidthSpin );
54 mLockAspectRatio->setHeightSpinBox( mHeightSpin );
55
56 mSymbolButton->setSymbolType( Qgis::SymbolType::Fill );
57 mSymbolButton->setSymbol( mPage->pageStyleSymbol()->clone() );
58
59 connect( mPageSizeComboBox, static_cast<void ( QComboBox::* )( int )>( &QComboBox::currentIndexChanged ), this, &QgsLayoutPagePropertiesWidget::pageSizeChanged );
60 connect( mPageOrientationComboBox, static_cast<void ( QComboBox::* )( int )>( &QComboBox::currentIndexChanged ), this, &QgsLayoutPagePropertiesWidget::orientationChanged );
61
62 connect( mWidthSpin, static_cast< void ( QDoubleSpinBox::* )( double )>( &QDoubleSpinBox::valueChanged ), this, &QgsLayoutPagePropertiesWidget::updatePageSize );
63 connect( mHeightSpin, static_cast< void ( QDoubleSpinBox::* )( double )>( &QDoubleSpinBox::valueChanged ), this, &QgsLayoutPagePropertiesWidget::updatePageSize );
64 connect( mWidthSpin, static_cast< void ( QDoubleSpinBox::* )( double )>( &QDoubleSpinBox::valueChanged ), this, &QgsLayoutPagePropertiesWidget::setToCustomSize );
65 connect( mHeightSpin, static_cast< void ( QDoubleSpinBox::* )( double )>( &QDoubleSpinBox::valueChanged ), this, &QgsLayoutPagePropertiesWidget::setToCustomSize );
66 connect( mExcludePageCheckBox, &QCheckBox::toggled, this, &QgsLayoutPagePropertiesWidget::excludeExportsToggled );
67
68 connect( mSymbolButton, &QgsSymbolButton::changed, this, &QgsLayoutPagePropertiesWidget::symbolChanged );
74
75 connect( mPaperSizeDDBtn, &QgsPropertyOverrideButton::changed, this, &QgsLayoutPagePropertiesWidget::refreshLayout );
76 connect( mWidthDDBtn, &QgsPropertyOverrideButton::changed, this, &QgsLayoutPagePropertiesWidget::refreshLayout );
77 connect( mHeightDDBtn, &QgsPropertyOverrideButton::changed, this, &QgsLayoutPagePropertiesWidget::refreshLayout );
78 connect( mOrientationDDBtn, &QgsPropertyOverrideButton::changed, this, &QgsLayoutPagePropertiesWidget::refreshLayout );
79
80 mExcludePageDDBtn->registerEnabledWidget( mExcludePageCheckBox, false );
81
82 mSymbolButton->registerExpressionContextGenerator( mPage );
83 mSymbolButton->setLayer( coverageLayer() );
84 if ( mPage->layout() )
85 {
87 }
88
89 showCurrentPageSize();
90}
91
92void QgsLayoutPagePropertiesWidget::pageSizeChanged( int )
93{
94 mBlockPageUpdate = true;
95 if ( mPageSizeComboBox->currentData().toString().isEmpty() )
96 {
97 //custom size
98 mLockAspectRatio->setEnabled( true );
99 mSizeUnitsComboBox->setEnabled( true );
100 mPageOrientationComboBox->setEnabled( false );
101 }
102 else
103 {
104 mLockAspectRatio->setEnabled( false );
105 mLockAspectRatio->setLocked( false );
106 mSizeUnitsComboBox->setEnabled( false );
107 mPageOrientationComboBox->setEnabled( true );
108 const QgsPageSize size = QgsApplication::pageSizeRegistry()->find( mPageSizeComboBox->currentData().toString() ).value( 0 );
109 const QgsLayoutSize convertedSize = mConverter.convert( size.size, mSizeUnitsComboBox->unit() );
110 mSettingPresetSize = true;
111 switch ( mPageOrientationComboBox->currentData().toInt() )
112 {
114 mWidthSpin->setValue( convertedSize.height() );
115 mHeightSpin->setValue( convertedSize.width() );
116 break;
117
119 mWidthSpin->setValue( convertedSize.width() );
120 mHeightSpin->setValue( convertedSize.height() );
121 break;
122 }
123 mSettingPresetSize = false;
124 }
125 mBlockPageUpdate = false;
126 updatePageSize();
127}
128
129void QgsLayoutPagePropertiesWidget::orientationChanged( int )
130{
131 if ( mPageSizeComboBox->currentData().toString().isEmpty() )
132 return;
133
134 const double width = mWidthSpin->value();
135 const double height = mHeightSpin->value();
136 switch ( mPageOrientationComboBox->currentData().toInt() )
137 {
139 if ( width < height )
140 {
141 whileBlocking( mWidthSpin )->setValue( height );
142 whileBlocking( mHeightSpin )->setValue( width );
143 }
144 break;
145
147 if ( width > height )
148 {
149 whileBlocking( mWidthSpin )->setValue( height );
150 whileBlocking( mHeightSpin )->setValue( width );
151 }
152 break;
153 }
154
155 updatePageSize();
156}
157
158void QgsLayoutPagePropertiesWidget::updatePageSize()
159{
160 if ( mBlockPageUpdate )
161 return;
162
163 mPage->layout()->undoStack()->beginMacro( tr( "Change Page Size" ) );
165 mPage->layout()->undoStack()->beginCommand( mPage, tr( "Change Page Size" ), 1 + mPage->layout()->pageCollection()->pageNumber( mPage ) );
166 mPage->setPageSize( QgsLayoutSize( mWidthSpin->value(), mHeightSpin->value(), mSizeUnitsComboBox->unit() ) );
167 mPage->layout()->undoStack()->endCommand();
168 mPage->layout()->pageCollection()->reflow();
170 mPage->layout()->undoStack()->endMacro();
171
172 refreshLayout();
174}
175
176void QgsLayoutPagePropertiesWidget::setToCustomSize()
177{
178 if ( mSettingPresetSize )
179 return;
180 whileBlocking( mPageSizeComboBox )->setCurrentIndex( mPageSizeComboBox->count() - 1 );
181 mPageOrientationComboBox->setEnabled( false );
182 pageSizeChanged( mPageSizeComboBox->currentIndex() );
183}
184
185void QgsLayoutPagePropertiesWidget::symbolChanged()
186{
187 mPage->layout()->undoStack()->beginCommand( mPage->layout()->pageCollection(), tr( "Change Page Background" ), QgsLayoutItemPage::UndoPageSymbol );
188 mPage->setPageStyleSymbol( static_cast< QgsFillSymbol * >( mSymbolButton->symbol() )->clone() );
189 mPage->layout()->undoStack()->endCommand();
190}
191
192void QgsLayoutPagePropertiesWidget::excludeExportsToggled( bool checked )
193{
194 mPage->beginCommand( !checked ? tr( "Include Page in Exports" ) : tr( "Exclude Page from Exports" ) );
195 mPage->setExcludeFromExports( checked );
196 mPage->endCommand();
197}
198
199void QgsLayoutPagePropertiesWidget::refreshLayout()
200{
201 mPage->layout()->refresh();
202}
203
204void QgsLayoutPagePropertiesWidget::showCurrentPageSize()
205{
206 const QgsLayoutSize paperSize = mPage->pageSize();
207 const QString pageSize = QgsApplication::pageSizeRegistry()->find( paperSize );
208 if ( !pageSize.isEmpty() )
209 {
210 whileBlocking( mPageSizeComboBox )->setCurrentIndex( mPageSizeComboBox->findData( pageSize ) );
211 mLockAspectRatio->setEnabled( false );
212 mLockAspectRatio->setLocked( false );
213 mSizeUnitsComboBox->setEnabled( false );
214 mPageOrientationComboBox->setEnabled( true );
215 }
216 else
217 {
218 // custom
219 whileBlocking( mPageSizeComboBox )->setCurrentIndex( mPageSizeComboBox->count() - 1 );
220 mLockAspectRatio->setEnabled( true );
221 mSizeUnitsComboBox->setEnabled( true );
222 mPageOrientationComboBox->setEnabled( false );
223 }
224}
@ 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, QgsUnitTypes::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
QgsUnitTypes::LayoutUnit units() const
Returns the units for the size.
double height() const
Returns the height of the size.
Definition: qgslayoutsize.h:90
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:359
QgsLayoutPageCollection * pageCollection()
Returns a pointer to the layout's page collection, which stores and manages page items in the layout.
Definition: qgslayout.cpp:459
void refresh()
Forces the layout, and all items contained within it, to refresh.
Definition: qgslayout.cpp:804
QgsLayoutReportContext & reportContext()
Returns a reference to the layout's report context, which stores information relating to the current ...
Definition: qgslayout.cpp:369
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:686
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:2453