qgslayoutitemgroup.cpp

Go to the documentation of this file.

/***************************************************************************
                              qgslayoutitemgroup.cpp
                             -----------------------
    begin                : October 2017
    copyright            : (C) 2017 by Nyall Dawson
    email                : nyall dot dawson at gmail dot com
 ***************************************************************************/
/***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
#include "qgslayoutitemgroup.h"
#include "qgslayoutitemregistry.h"
#include "qgslayout.h"
#include "qgslayoututils.h"
#include "qgslayoutundostack.h"
#include "qgslayoutpagecollection.h"
 
QgsLayoutItemGroup::QgsLayoutItemGroup( QgsLayout *layout )
  : QgsLayoutItem( layout )
{}
 
QgsLayoutItemGroup::~QgsLayoutItemGroup()
{
  QgsLayoutItemGroup::cleanup();
}
 
void QgsLayoutItemGroup::cleanup()
{
  //loop through group members and remove them from the scene
  for ( QgsLayoutItem *item : std::as_const( mItems ) )
  {
    if ( !item )
      continue;
 
    //inform model that we are about to remove an item from the scene
    if ( mLayout )
      mLayout->removeLayoutItem( item );
    else
    {
      item->cleanup();
      item->deleteLater();
    }
  }
  mItems.clear();
  QgsLayoutItem::cleanup();
}
 
int QgsLayoutItemGroup::type() const
{
  return QgsLayoutItemRegistry::LayoutGroup;
}
 
QString QgsLayoutItemGroup::displayName() const
{
  //return id, if it's not empty
  if ( !id().isEmpty() )
  {
    return id();
  }
  return tr( "<Group>" );
}
 
QgsLayoutItemGroup *QgsLayoutItemGroup::create( QgsLayout *layout )
{
  return new QgsLayoutItemGroup( layout );
}
 
void QgsLayoutItemGroup::addItem( QgsLayoutItem *item )
{
  if ( !item )
  {
    return;
  }
 
  if ( mItems.contains( item ) )
  {
    return;
  }
 
  mItems << QPointer< QgsLayoutItem >( item );
  item->setParentGroup( this );
 
  updateBoundingRect();
}
 
void QgsLayoutItemGroup::removeItems()
{
  for ( QgsLayoutItem *item : std::as_const( mItems ) )
  {
    if ( !item )
      continue;
 
    item->setParentGroup( nullptr );
  }
  mItems.clear();
}
 
QList<QgsLayoutItem *> QgsLayoutItemGroup::items() const
{
  QList<QgsLayoutItem *> val;
  for ( QgsLayoutItem *item : std::as_const( mItems ) )
  {
    if ( !item )
      continue;
    val << item;
  }
  return val;
}
 
void QgsLayoutItemGroup::setVisibility( const bool visible )
{
  if ( !shouldBlockUndoCommands() )
    mLayout->undoStack()->beginMacro( tr( "Set Group Visibility" ) );
  //also set visibility for all items within the group
  for ( QgsLayoutItem *item : std::as_const( mItems ) )
  {
    if ( !item )
      continue;
    bool prev = item->mBlockUndoCommands;
    item->mBlockUndoCommands = mBlockUndoCommands;
    item->setVisibility( visible );
    item->mBlockUndoCommands = prev;
  }
  //lastly set visibility for group item itself
  QgsLayoutItem::setVisibility( visible );
 
  if ( !shouldBlockUndoCommands() )
    mLayout->undoStack()->endMacro();
}
 
void QgsLayoutItemGroup::attemptMove( const QgsLayoutPoint &point, bool useReferencePoint, bool includesFrame, int page )
{
  Q_UNUSED( useReferencePoint ) //groups should always have reference point in top left
  if ( !mLayout )
    return;
 
  if ( !shouldBlockUndoCommands() )
    mLayout->undoStack()->beginMacro( tr( "Move group" ) );
 
  QPointF scenePoint;
  if ( page < 0 )
    scenePoint = mLayout->convertToLayoutUnits( point );
  else
    scenePoint = mLayout->pageCollection()->pagePositionToLayoutPosition( page, point );
 
  double deltaX = scenePoint.x() - pos().x();
  double deltaY = scenePoint.y() - pos().y();
 
  //also move all items within the group
  for ( QgsLayoutItem *item : std::as_const( mItems ) )
  {
    if ( !item )
      continue;
 
    std::unique_ptr< QgsAbstractLayoutUndoCommand > command;
    if ( !shouldBlockUndoCommands() )
    {
      command.reset( createCommand( QString(), 0 ) );
      command->saveBeforeState();
    }
 
    item->attemptMoveBy( deltaX, deltaY );
 
    if ( command )
    {
      command->saveAfterState();
      mLayout->undoStack()->push( command.release() );
    }
  }
  //lastly move group item itself
  QgsLayoutItem::attemptMove( point, includesFrame );
  if ( !shouldBlockUndoCommands() )
    mLayout->undoStack()->endMacro();
  updateBoundingRect();
}
 
void QgsLayoutItemGroup::attemptResize( const QgsLayoutSize &size, bool includesFrame )
{
  if ( !mLayout )
    return;
 
  if ( !shouldBlockUndoCommands() )
    mLayout->undoStack()->beginMacro( tr( "Resize Group" ) );
 
  QRectF oldRect = rect();
  QSizeF newSizeLayoutUnits = mLayout->convertToLayoutUnits( size );
  QRectF newRect;
  newRect.setSize( newSizeLayoutUnits );
 
  //also resize all items within the group
  for ( QgsLayoutItem *item : std::as_const( mItems ) )
  {
    if ( !item )
      continue;
 
    std::unique_ptr< QgsAbstractLayoutUndoCommand > command;
    if ( !shouldBlockUndoCommands() )
    {
      command.reset( createCommand( QString(), 0 ) );
      command->saveBeforeState();
    }
 
    QRectF itemRect = mapRectFromItem( item, item->rect() );
    QgsLayoutUtils::relativeResizeRect( itemRect, oldRect, newRect );
 
    itemRect = itemRect.normalized();
    QPointF newPos = mapToScene( itemRect.topLeft() );
 
    QgsLayoutSize itemSize = mLayout->convertFromLayoutUnits( itemRect.size(), item->sizeWithUnits().units() );
    item->attemptResize( itemSize, includesFrame );
 
    // translate new position to current item units
    QgsLayoutPoint itemPos = mLayout->convertFromLayoutUnits( newPos, item->positionWithUnits().units() );
    item->attemptMove( itemPos, false );
 
    if ( command )
    {
      command->saveAfterState();
      mLayout->undoStack()->push( command.release() );
    }
  }
  QgsLayoutItem::attemptResize( size );
  if ( !shouldBlockUndoCommands() )
    mLayout->undoStack()->endMacro();
 
  updateBoundingRect();
}
 
bool QgsLayoutItemGroup::writePropertiesToElement( QDomElement &element, QDomDocument &document, const QgsReadWriteContext & ) const
{
  for ( QgsLayoutItem *item : mItems )
  {
    if ( !item )
      continue;
 
    QDomElement childItem = document.createElement( QStringLiteral( "ComposerItemGroupElement" ) );
    childItem.setAttribute( QStringLiteral( "uuid" ), item->uuid() );
    element.appendChild( childItem );
  }
  return true;
}
 
bool QgsLayoutItemGroup::readPropertiesFromElement( const QDomElement &itemElement, const QDomDocument &, const QgsReadWriteContext & )
{
  mItemUuids.clear();
 
  QDomNodeList elementNodes = itemElement.elementsByTagName( QStringLiteral( "ComposerItemGroupElement" ) );
  for ( int i = 0; i < elementNodes.count(); ++i )
  {
    QDomNode elementNode = elementNodes.at( i );
    if ( !elementNode.isElement() )
      continue;
 
    QString uuid = elementNode.toElement().attribute( QStringLiteral( "uuid" ) );
    mItemUuids << uuid;
  }
  return true;
}
 
void QgsLayoutItemGroup::finalizeRestoreFromXml()
{
  for ( const QString &uuid : std::as_const( mItemUuids ) )
  {
    QgsLayoutItem *item = mLayout->itemByUuid( uuid, true );
    if ( item )
    {
      addItem( item );
    }
  }
 
  updateBoundingRect();
}
 
QgsLayoutItem::ExportLayerBehavior QgsLayoutItemGroup::exportLayerBehavior() const
{
  return MustPlaceInOwnLayer;
}
 
void QgsLayoutItemGroup::paint( QPainter *, const QStyleOptionGraphicsItem *, QWidget * )
{
}
 
void QgsLayoutItemGroup::draw( QgsLayoutItemRenderContext & )
{
  // nothing to draw here!
}
 
 
void QgsLayoutItemGroup::updateBoundingRect()
{
 
  if ( mItems.isEmpty() )
  {
    setRect( QRectF() );
    return;
  }
 
  //check if all child items have same rotation
  auto itemIter = mItems.constBegin();
 
  //start with rotation of first child
  double rotation = ( *itemIter )->rotation();
 
  //iterate through remaining children, checking if they have same rotation
  for ( ++itemIter; itemIter != mItems.constEnd(); ++itemIter )
  {
    if ( !qgsDoubleNear( ( *itemIter )->rotation(), rotation ) )
    {
      //item has a different rotation
      rotation = 0.0;
      break;
    }
  }
  setScenePos( QPointF( 0, 0 ) );
  setItemRotation( rotation );
 
  itemIter = mItems.constBegin();
 
  // start with handle bounds of first child
  QRectF groupRect = mapFromItem( ( *itemIter ), ( *itemIter )->rect() ).boundingRect();
  QRectF groupRectWithFrame = mapFromItem( ( *itemIter ), ( *itemIter )->rectWithFrame() ).boundingRect();
 
  //iterate through remaining children, expanding the bounds as required
  for ( ++itemIter; itemIter != mItems.constEnd(); ++itemIter )
  {
    groupRect |= mapFromItem( ( *itemIter ), ( *itemIter )->rect() ).boundingRect();
    groupRectWithFrame |= mapFromItem( ( *itemIter ), ( *itemIter )->rectWithFrame() ).boundingRect();
  }
 
  mItemSize = mLayout->convertFromLayoutUnits( groupRect.size(), sizeWithUnits().units() );
  mItemPosition = mLayout->convertFromLayoutUnits( mapToScene( groupRect.topLeft() ), positionWithUnits().units() );
  setRect( 0, 0, groupRect.width(), groupRect.height() );
  setPos( mapToScene( groupRect.topLeft() ) );
 
  QPointF bleedShift = groupRectWithFrame.topLeft() - groupRect.topLeft();
  mRectWithFrame = QRectF( bleedShift, groupRectWithFrame.size() );
}
 
QRectF QgsLayoutItemGroup::rectWithFrame() const
{
  return mRectWithFrame;
}