QGIS API Documentation 3.99.0-Master (2fe06baccd8)
Loading...
Searching...
No Matches
qgslayoutmultiframeundocommand.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgslayoutmultiframeundocommand.cpp
3 ----------------------
4 begin : October 2017
5 copyright : (C) 2017 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
19
20#include "qgsfeedback.h"
21#include "qgslayout.h"
22#include "qgslayoutmultiframe.h"
23#include "qgsproject.h"
24#include "qgsreadwritecontext.h"
25
27QgsLayoutMultiFrameUndoCommand::QgsLayoutMultiFrameUndoCommand( QgsLayoutMultiFrame *frame, const QString &text, int id, QUndoCommand *parent )
28 : QgsAbstractLayoutUndoCommand( text, id, parent )
29 , mFrameUuid( frame->uuid() )
30 , mLayout( frame->layout() )
31 , mItemType( frame->type() )
32{
33
34}
35
36bool QgsLayoutMultiFrameUndoCommand::mergeWith( const QUndoCommand *command )
37{
38 if ( command->id() == 0 )
39 return false;
40
41 const QgsLayoutMultiFrameUndoCommand *c = dynamic_cast<const QgsLayoutMultiFrameUndoCommand *>( command );
42 if ( !c )
43 {
44 return false;
45 }
46 if ( c->multiFrameUuid() != multiFrameUuid() )
47 return false;
48
49 setAfterState( c->afterState() );
50 return true;
51}
52
53void QgsLayoutMultiFrameUndoCommand::saveState( QDomDocument &stateDoc ) const
54{
55 stateDoc.clear();
56 QDomElement documentElement = stateDoc.createElement( QStringLiteral( "ItemState" ) );
57
58 QgsLayoutMultiFrame *item = mLayout->multiFrameByUuid( mFrameUuid );
59 Q_ASSERT_X( item, "QgsLayoutMultiFrameUndoCommand::saveState", "could not retrieve item for saving state" );
60
61 item->writeXml( documentElement, stateDoc, QgsReadWriteContext(), true );
62 stateDoc.appendChild( documentElement );
63}
64
65void QgsLayoutMultiFrameUndoCommand::restoreState( QDomDocument &stateDoc )
66{
67 // find item by uuid...
68 QgsLayoutMultiFrame *item = mLayout->multiFrameByUuid( mFrameUuid );
69 if ( !item )
70 {
71 // uh oh - it's been deleted! we need to create a new instance
72 item = recreateItem( mItemType, mLayout );
73 }
74
75 item->readXml( stateDoc.documentElement().firstChild().toElement(), stateDoc, QgsReadWriteContext(), true );
77 mLayout->project()->setDirty( true );
78}
79
80QgsLayoutMultiFrame *QgsLayoutMultiFrameUndoCommand::recreateItem( int itemType, QgsLayout *layout )
81{
83 mLayout->addMultiFrame( item );
84 return item;
85}
86
87QString QgsLayoutMultiFrameUndoCommand::multiFrameUuid() const
88{
89 return mFrameUuid;
90}
91
92QgsLayout *QgsLayoutMultiFrameUndoCommand::layout() const
93{
94 return mLayout;
95}
96
97
98//
99// QgsLayoutMultiFrameDeleteUndoCommand
100//
101
102QgsLayoutMultiFrameDeleteUndoCommand::QgsLayoutMultiFrameDeleteUndoCommand( QgsLayoutMultiFrame *item, const QString &text, int id, QUndoCommand *parent )
103 : QgsLayoutMultiFrameUndoCommand( item, text, id, parent )
104{
105 saveBeforeState();
106}
107
108bool QgsLayoutMultiFrameDeleteUndoCommand::mergeWith( const QUndoCommand * )
109{
110 return false;
111}
112
113void QgsLayoutMultiFrameDeleteUndoCommand::redo()
114{
115 if ( mFirstRun )
116 {
117 mFirstRun = false;
118 return;
119 }
120
121 QgsLayoutMultiFrame *item = layout()->multiFrameByUuid( multiFrameUuid() );
122 //Q_ASSERT_X( item, "QgsLayoutMultiFrameDeleteUndoCommand::redo", "could not find item to re-delete!" );
123
124 if ( item )
125 {
126 layout()->removeMultiFrame( item );
127 delete item;
128 }
129}
130
131QgsLayoutMultiFrameAddItemCommand::QgsLayoutMultiFrameAddItemCommand( QgsLayoutMultiFrame *frame, const QString &text, int id, QUndoCommand *parent )
132 : QgsLayoutMultiFrameUndoCommand( frame, text, id, parent )
133{
134 saveAfterState();
135}
136
137bool QgsLayoutMultiFrameAddItemCommand::containsChange() const
138{
139 return true;
140}
141
142bool QgsLayoutMultiFrameAddItemCommand::mergeWith( const QUndoCommand * )
143{
144 return false;
145}
146
147void QgsLayoutMultiFrameAddItemCommand::undo()
148{
149 if ( mFirstRun )
150 {
151 mFirstRun = false;
152 return;
153 }
154
155 QgsLayoutMultiFrame *item = layout()->multiFrameByUuid( multiFrameUuid() );
156 if ( item )
157 {
158 layout()->removeMultiFrame( item );
159 delete item;
160 }
161}
162
163
Base class for commands to undo/redo layout and layout object changes.
static QgsLayoutItemRegistry * layoutItemRegistry()
Returns the application's layout item registry, used for layout item types.
QgsLayoutMultiFrame * createMultiFrame(int type, QgsLayout *layout) const
Creates a new instance of a layout multiframe given the multiframe type, and target layout.
Abstract base class for layout items with the ability to distribute the content to several frames (Qg...
bool writeXml(QDomElement &parentElement, QDomDocument &document, const QgsReadWriteContext &context, bool includeFrames=false) const
Stores the multiframe state in a DOM element.
virtual void finalizeRestoreFromXml()
Called after all pending items have been restored from XML.
bool readXml(const QDomElement &itemElement, const QDomDocument &document, const QgsReadWriteContext &context, bool includeFrames=false)
Sets the item state from a DOM element.
Base class for layouts, which can contain items such as maps, labels, scalebars, etc.
Definition qgslayout.h:50
void removeMultiFrame(QgsLayoutMultiFrame *multiFrame)
Removes a multiFrame from the layout (but does not delete it).
QgsLayoutMultiFrame * multiFrameByUuid(const QString &uuid, bool includeTemplateUuids=false) const
Returns the layout multiframe with matching uuid unique identifier, or nullptr if a matching multifra...
A container for the context for various read/write operations on objects.
As part of the API refactoring and improvements which landed in the Processing API was substantially reworked from the x version This was done in order to allow much of the underlying Processing framework to be ported into c