QgsLayoutModel Class Reference

A model for items attached to a layout. The model also maintains the z-order for the layout, and must be notified whenever item stacking changes. More...

#include <qgslayoutmodel.h>

Inheritance diagram for QgsLayoutModel:

Public Types
enum	Columns { Visibility = 0, LockStatus, ItemId }
	Columns returned by the model. More...

Public Member Functions
	QgsLayoutModel (QgsLayout *layout, QObject *parent=nullptr)
	Constructor for a QgsLayoutModel attached to the specified layout. More...
int	columnCount (const QModelIndex &parent=QModelIndex()) const override
QVariant	data (const QModelIndex &index, int role) const override
bool	dropMimeData (const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) override
Qt::ItemFlags	flags (const QModelIndex &index) const override
QVariant	headerData (int section, Qt::Orientation orientation, int role=Qt::DisplayRole) const override
QModelIndex	index (int row, int column, const QModelIndex &parent=QModelIndex()) const override
QModelIndex	indexForItem (QgsLayoutItem *item, int column=0)
	Returns the QModelIndex corresponding to a QgsLayoutItem item and column, if possible. More...
QgsLayoutItem *	itemFromIndex (const QModelIndex &index) const
	Returns the QgsLayoutItem corresponding to a QModelIndex index, if possible. More...
QMimeData *	mimeData (const QModelIndexList &indexes) const override
QStringList	mimeTypes () const override
QModelIndex	parent (const QModelIndex &index) const override
bool	removeRows (int row, int count, const QModelIndex &parent=QModelIndex()) override
int	rowCount (const QModelIndex &parent=QModelIndex()) const override
bool	setData (const QModelIndex &index, const QVariant &value, int role) override
Qt::DropActions	supportedDropActions () const override

Friends
class	TestQgsLayoutGui
class	TestQgsLayoutModel

Detailed Description

A model for items attached to a layout. The model also maintains the z-order for the layout, and must be notified whenever item stacking changes.

Internally, QgsLayoutModel maintains two lists. One contains a complete list of all items for the layout, ordered by their position within the z-order stack.

The second list contains only items which are currently displayed in the layout's scene. It is used as a cache of the last known stacking order, so that the model can compare the current stacking of items in the layout to the last known state, and emit the corresponding signals as required.

Since

QGIS 3.0

Definition at line 52 of file qgslayoutmodel.h.

Member Enumeration Documentation

Columns

enum QgsLayoutModel::Columns

Columns returned by the model.

Enumerator
Visibility	Item visibility checkbox.
LockStatus	Item lock status checkbox.
ItemId	Item ID.

Definition at line 59 of file qgslayoutmodel.h.

Constructor & Destructor Documentation

QgsLayoutModel()

QgsLayoutModel::QgsLayoutModel ( QgsLayout *  layout, QObject *  parent = nullptr  )

explicit

Constructor for a QgsLayoutModel attached to the specified layout.

Definition at line 32 of file qgslayoutmodel.cpp.

Member Function Documentation

columnCount()

int QgsLayoutModel::columnCount ( const QModelIndex &  parent = QModelIndex() ) const

override

Definition at line 119 of file qgslayoutmodel.cpp.

data()

QVariant QgsLayoutModel::data ( const QModelIndex &  index, int  role  ) const

override

Definition at line 125 of file qgslayoutmodel.cpp.

dropMimeData()

bool QgsLayoutModel::dropMimeData ( const QMimeData *  data, Qt::DropAction  action, int  row, int  column, const QModelIndex &  parent  )

override

Definition at line 308 of file qgslayoutmodel.cpp.

flags()

Qt::ItemFlags QgsLayoutModel::flags ( const QModelIndex &  index ) const

override

Definition at line 875 of file qgslayoutmodel.cpp.

headerData()

QVariant QgsLayoutModel::headerData ( int  section, Qt::Orientation  orientation, int  role = Qt::DisplayRole  ) const

override

Definition at line 230 of file qgslayoutmodel.cpp.

index()

QModelIndex QgsLayoutModel::index ( int  row, int  column, const QModelIndex &  parent = QModelIndex()  ) const

override

Definition at line 51 of file qgslayoutmodel.cpp.

indexForItem()

QModelIndex QgsLayoutModel::indexForItem	(	QgsLayoutItem *	item,
		int	column = 0
	)

Returns the QModelIndex corresponding to a QgsLayoutItem item and column, if possible.

See also

itemFromIndex()

Definition at line 903 of file qgslayoutmodel.cpp.

itemFromIndex()

QgsLayoutItem * QgsLayoutModel::itemFromIndex

(

const QModelIndex &

index

)

const

Returns the QgsLayoutItem corresponding to a QModelIndex index, if possible.

See also

indexForItem()

Definition at line 39 of file qgslayoutmodel.cpp.

mimeData()

QMimeData * QgsLayoutModel::mimeData ( const QModelIndexList &  indexes ) const

override

Definition at line 278 of file qgslayoutmodel.cpp.

mimeTypes()

QStringList QgsLayoutModel::mimeTypes ( ) const

override

Definition at line 271 of file qgslayoutmodel.cpp.

parent()

QModelIndex QgsLayoutModel::parent ( const QModelIndex &  index ) const

override

Definition at line 90 of file qgslayoutmodel.cpp.

removeRows()

bool QgsLayoutModel::removeRows ( int  row, int  count, const QModelIndex &  parent = QModelIndex()  )

override

Definition at line 413 of file qgslayoutmodel.cpp.

rowCount()

int QgsLayoutModel::rowCount ( const QModelIndex &  parent = QModelIndex() ) const

override

Definition at line 98 of file qgslayoutmodel.cpp.

setData()

bool QgsLayoutModel::setData ( const QModelIndex &  index, const QVariant &  value, int  role = Qt::EditRole  )

override

Definition at line 196 of file qgslayoutmodel.cpp.

supportedDropActions()

Qt::DropActions QgsLayoutModel::supportedDropActions ( ) const

override

Definition at line 266 of file qgslayoutmodel.cpp.

Friends And Related Function Documentation

TestQgsLayoutGui

friend class TestQgsLayoutGui

friend

Definition at line 296 of file qgslayoutmodel.h.

TestQgsLayoutModel

friend class TestQgsLayoutModel

friend

Definition at line 295 of file qgslayoutmodel.h.

---

The documentation for this class was generated from the following files:

• /build/qgis-3.26.3+32focal/src/core/layout/qgslayoutmodel.h
• /build/qgis-3.26.3+32focal/src/core/layout/qgslayoutmodel.cpp