38     mPageSizeComboBox->addItem( size.displayName, size.name );
 
   40   mPageSizeComboBox->addItem( tr( 
"Custom" ) );
 
   47   mPageOrientationComboBox->setCurrentIndex( mPageOrientationComboBox->findData( mPage->
orientation() ) );
 
   49   mSizeUnitsComboBox->linkToWidget( mWidthSpin );
 
   50   mSizeUnitsComboBox->linkToWidget( mHeightSpin );
 
   53   mLockAspectRatio->setWidthSpinBox( mWidthSpin );
 
   54   mLockAspectRatio->setHeightSpinBox( mHeightSpin );
 
   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 );
 
   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 );
 
   80   mExcludePageDDBtn->registerEnabledWidget( mExcludePageCheckBox, 
false );
 
   82   mSymbolButton->registerExpressionContextGenerator( mPage );
 
   89   showCurrentPageSize();
 
   92 void QgsLayoutPagePropertiesWidget::pageSizeChanged( 
int )
 
   94   mBlockPageUpdate = 
true;
 
   95   if ( mPageSizeComboBox->currentData().toString().isEmpty() )
 
   98     mLockAspectRatio->setEnabled( 
true );
 
   99     mSizeUnitsComboBox->setEnabled( 
true );
 
  100     mPageOrientationComboBox->setEnabled( 
false );
 
  104     mLockAspectRatio->setEnabled( 
false );
 
  105     mLockAspectRatio->setLocked( 
false );
 
  106     mSizeUnitsComboBox->setEnabled( 
false );
 
  107     mPageOrientationComboBox->setEnabled( 
true );
 
  110     mSettingPresetSize = 
true;
 
  111     switch ( mPageOrientationComboBox->currentData().toInt() )
 
  114         mWidthSpin->setValue( convertedSize.
height() );
 
  115         mHeightSpin->setValue( convertedSize.
width() );
 
  119         mWidthSpin->setValue( convertedSize.
width() );
 
  120         mHeightSpin->setValue( convertedSize.
height() );
 
  123     mSettingPresetSize = 
false;
 
  125   mBlockPageUpdate = 
false;
 
  129 void QgsLayoutPagePropertiesWidget::orientationChanged( 
int )
 
  131   if ( mPageSizeComboBox->currentData().toString().isEmpty() )
 
  134   double width = mWidthSpin->value();
 
  135   double height = mHeightSpin->value();
 
  136   switch ( mPageOrientationComboBox->currentData().toInt() )
 
  139       if ( width < height )
 
  147       if ( width > height )
 
  158 void QgsLayoutPagePropertiesWidget::updatePageSize()
 
  160   if ( mBlockPageUpdate )
 
  176 void QgsLayoutPagePropertiesWidget::setToCustomSize()
 
  178   if ( mSettingPresetSize )
 
  180   whileBlocking( mPageSizeComboBox )->setCurrentIndex( mPageSizeComboBox->count() - 1 );
 
  181   mPageOrientationComboBox->setEnabled( 
false );
 
  184 void QgsLayoutPagePropertiesWidget::symbolChanged()
 
  191 void QgsLayoutPagePropertiesWidget::excludeExportsToggled( 
bool checked )
 
  193   mPage->
beginCommand( !checked ? tr( 
"Include Page in Exports" ) : tr( 
"Exclude Page from Exports" ) );
 
  198 void QgsLayoutPagePropertiesWidget::refreshLayout()
 
  203 void QgsLayoutPagePropertiesWidget::showCurrentPageSize()
 
  207   if ( !pageSize.isEmpty() )
 
  209     whileBlocking( mPageSizeComboBox )->setCurrentIndex( mPageSizeComboBox->findData( pageSize ) );
 
  210     mLockAspectRatio->setEnabled( 
false );
 
  211     mLockAspectRatio->setLocked( 
false );
 
  212     mSizeUnitsComboBox->setEnabled( 
false );
 
  213     mPageOrientationComboBox->setEnabled( 
true );
 
  218     whileBlocking( mPageSizeComboBox )->setCurrentIndex( mPageSizeComboBox->count() - 1 );
 
  219     mLockAspectRatio->setEnabled( 
true );
 
  220     mSizeUnitsComboBox->setEnabled( 
true );
 
  221     mPageOrientationComboBox->setEnabled( 
false );
 
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.
QgsFillSymbol * clone() const override
Returns a deep copy of this symbol.
Item representing the paper in a layout.
const QgsFillSymbol * pageStyleSymbol() const
Returns the symbol to use for drawing the page background.
void setPageSize(const QgsLayoutSize &size)
Sets the size of the page.
QgsLayoutSize pageSize() const
Returns the size of the page.
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...
QgsUnitTypes::LayoutUnit units() const
Returns the units for the size.
double height() const
Returns the height of the size.
double width() const
Returns the width of the size.
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 ...
QgsLayoutPageCollection * pageCollection()
Returns a pointer to the layout's page collection, which stores and manages page items in the layout.
void refresh()
Forces the layout, and all items contained within it, to refresh.
QgsLayoutReportContext & reportContext()
Returns a reference to the layout's report context, which stores information relating to the current ...
QgsLayoutUndoStack * undoStack()
Returns a pointer to the layout's undo stack, which manages undo/redo states for the layout and it's ...
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.
QgsSignalBlocker< Object > whileBlocking(Object *object)
Temporarily blocks signals from a QObject while calling a single method from the object.