QGIS API Documentation 4.1.0-Master (5bf3c20f3c9)
Loading...
Searching...
No Matches
qgslayoutitemguiregistry.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgslayoutitemregistry.cpp
3 -------------------------
4 begin : June 2017
5 copyright : (C) 2017 by Nyall Dawson
6 email : nyall dot dawson at gmail dot com
7 ***************************************************************************/
8/***************************************************************************
9 * *
10 * This program is free software; you can redistribute it and/or modify *
11 * it under the terms of the GNU General Public License as published by *
12 * the Free Software Foundation; either version 2 of the License, or *
13 * (at your option) any later version. *
14 * *
15 ***************************************************************************/
16
18
19#include "qgslayoutframe.h"
21#include "qgslayoutmultiframe.h"
23
24#include <QPainter>
25
26#include "moc_qgslayoutitemguiregistry.cpp"
27
32
34{
35 return nullptr;
36}
37
42
45
48
54
55
57 : QObject( parent )
58{}
59
61{
62 qDeleteAll( mMetadata );
63}
64
66{
67 return mMetadata.value( metadataId );
68}
69
71{
72 for ( auto it = mMetadata.constBegin(); it != mMetadata.constEnd(); ++it )
73 {
74 if ( it.value()->type() == type )
75 return it.key();
76 }
77 return -1;
78}
79
81{
82 if ( !metadata )
83 return false;
84
85 const int id = mMetadata.count();
86 mMetadata[id] = metadata;
87 emit typeAdded( id );
88 return true;
89}
90
92{
93 int metadataId = metadataIdForItemType( typeId );
94 auto it = mMetadata.find( metadataId );
95 if ( it == mMetadata.end() )
96 return false;
97 mMetadata.erase( it );
98 emit typeRemoved( metadataId );
99 return true;
100}
101
103{
104 if ( !metadata )
105 return false;
106 return removeLayoutItemGuiMetadata( metadata->type() );
107}
108
110{
111 if ( mItemGroups.contains( group.id ) )
112 return false;
113
114 mItemGroups.insert( group.id, group );
115 return true;
116}
117
119{
120 return mItemGroups[id];
121}
122
124{
125 auto it = mItemGroups.find( id );
126 if ( it == mItemGroups.end() )
127 return false;
128
129 mItemGroups.erase( it );
130 emit groupRemoved( id );
131 return true;
132}
133
135{
136 auto it = mMetadata.constFind( metadataId );
137 if ( it == mMetadata.constEnd() )
138 return nullptr;
139
140 std::unique_ptr<QgsLayoutItem> item( it.value()->createItem( layout ) );
141 if ( item )
142 return item.release();
143
144 const int type = it.value()->type();
145 return QgsApplication::layoutItemRegistry()->createItem( type, layout );
146}
147
148void QgsLayoutItemGuiRegistry::newItemAddedToLayout( int metadataId, QgsLayoutItem *item, const QVariantMap &properties )
149{
150 auto it = mMetadata.constFind( metadataId );
151 if ( it == mMetadata.constEnd() )
152 return;
153
154 if ( QgsLayoutItemGuiMetadata *metadata = dynamic_cast<QgsLayoutItemGuiMetadata *>( it.value() ) )
155 {
156 metadata->newItemAddedToLayout( item, properties );
157 }
158 else
159 {
160 it.value()->newItemAddedToLayout( item );
161 }
162}
163
165{
166 if ( !item )
167 return nullptr;
168
169 int type = item->type();
171 {
172 QgsLayoutMultiFrame *multiFrame = qobject_cast<QgsLayoutFrame *>( item )->multiFrame();
173 if ( multiFrame )
174 type = multiFrame->type();
175 }
176 for ( auto it = mMetadata.constBegin(); it != mMetadata.constEnd(); ++it )
177 {
178 if ( it.value()->type() == type )
179 return it.value()->createItemWidget( item );
180 }
181
182 return nullptr;
183}
184
186{
187 auto it = mMetadata.constFind( metadataId );
188 if ( it == mMetadata.constEnd() )
189 return nullptr;
190
191 return it.value()->createRubberBand( view );
192}
193
195{
196 auto it = mMetadata.constFind( metadataId );
197 if ( it == mMetadata.constEnd() )
198 return nullptr;
199
200 return it.value()->createNodeRubberBand( view );
201}
202
204{
205 return mMetadata.keys();
206}
207
212
214{
215 if ( mAddedToLayoutFunc )
216 mAddedToLayoutFunc( item, QVariantMap() );
217}
218
219void QgsLayoutItemGuiMetadata::newItemAddedToLayout( QgsLayoutItem *item, const QVariantMap &properties )
220{
221 if ( mAddedToLayoutFunc )
222 mAddedToLayoutFunc( item, properties );
223}
MouseHandlesAction
Action to be performed by the mouse handles.
Definition qgis.h:6382
static QgsLayoutItemRegistry * layoutItemRegistry()
Returns the application's layout item registry, used for layout item types.
Stores GUI metadata about one layout item class.
virtual QGraphicsItem * createNodeRubberBand(QgsLayoutView *view)
Creates a rubber band for use when creating layout node based items of this type.
virtual void handleDoubleClick(QgsLayoutItem *item, Qgis::MouseHandlesAction action)
Called when a layout item is double-clicked.
virtual QgsLayoutViewRubberBand * createRubberBand(QgsLayoutView *view)
Creates a rubber band for use when creating layout items of this type.
int type() const
Returns the unique item type code for the layout item class.
virtual void newItemAddedToLayout(QgsLayoutItem *item)
Called when a newly created item of the associated type has been added to a layout.
virtual QgsLayoutItem * createItem(QgsLayout *layout)
Creates an instance of the corresponding item type.
A base class for property widgets for layout items.
Stores GUI metadata about a group of layout item classes.
QString id
Unique (untranslated) group ID string.
Convenience metadata class that uses static functions to handle layout item GUI behavior.
QgsLayoutItemAddedToLayoutFunc mAddedToLayoutFunc
void handleDoubleClick(QgsLayoutItem *item, Qgis::MouseHandlesAction action) override
Called when a layout item is double-clicked.
QgsLayoutItemCreateFunc mCreateFunc
QgsLayoutItemDoubleClickedFunc mDoubleClickedFunc
QgsLayoutItem * createItem(QgsLayout *layout) override
Creates an instance of the corresponding item type.
void newItemAddedToLayout(QgsLayoutItem *item) override
Called when a newly created item of the associated type has been added to a layout.
bool removeItemGroup(const QString &id)
Unregisters an item group from the registry.
QgsLayoutItemBaseWidget * createItemWidget(QgsLayoutItem *item) const
Creates a new instance of a layout item configuration widget for the specified item.
bool removeLayoutItemGuiMetadata(int type)
Unregisters the GUI metadata for a layout item type.
void newItemAddedToLayout(int metadataId, QgsLayoutItem *item, const QVariantMap &properties=QVariantMap())
Called when a newly created item of the associated metadata metadataId has been added to a layout.
bool addItemGroup(const QgsLayoutItemGuiGroup &group)
Registers a new item group with the registry.
const QgsLayoutItemGuiGroup & itemGroup(const QString &id)
Returns a reference to the item group with matching id.
int metadataIdForItemType(int type) const
Returns the GUI item metadata ID which corresponds to the specified layout item type.
QgsLayoutItemGuiRegistry(QObject *parent=nullptr)
Creates a new empty item GUI registry.
QList< int > itemMetadataIds() const
Returns a list of available item metadata ids handled by the registry.
bool addLayoutItemGuiMetadata(QgsLayoutItemAbstractGuiMetadata *metadata)
Registers the GUI metadata for a new layout item type.
void typeRemoved(int metadataId)
Emitted whenever an item type is removed from the registry, with the specified metadataId.
void groupRemoved(QString groupId)
Emitted whenever an item group is removed from the registry.
QgsLayoutViewRubberBand * createItemRubberBand(int metadataId, QgsLayoutView *view) const
Creates a new rubber band item for the specified item metadataId and destination view.
QGraphicsItem * createNodeItemRubberBand(int metadataId, QgsLayoutView *view)
Creates a rubber band for the specified item metadataId and destination view.
QgsLayoutItem * createItem(int metadataId, QgsLayout *layout) const
Creates a new instance of a layout item given the item metadata metadataId, target layout.
QgsLayoutItemAbstractGuiMetadata * itemMetadata(int metadataId) const
Returns the metadata for the specified item metadataId.
void typeAdded(int metadataId)
Emitted whenever a new item type is added to the registry, with the specified metadataId.
@ LayoutFrame
Frame item, part of a QgsLayoutMultiFrame object.
QgsLayoutItem * createItem(int type, QgsLayout *layout) const
Creates a new instance of a layout item given the item type, and target layout.
Base class for graphical items within a QgsLayout.
int type() const override
Returns a unique graphics item type identifier.
Abstract base class for layout items with the ability to distribute the content to several frames (Qg...
virtual int type() const =0
Returns unique multiframe type id.
A rectangular rubber band for use within QgsLayoutView widgets.
An abstract base class for temporary rubber band items in various shapes, for use within QgsLayoutVie...
A graphical widget to display and interact with QgsLayouts.
Base class for layouts, which can contain items such as maps, labels, scalebars, etc.
Definition qgslayout.h:50