Class: QgsLayoutItemAbstractGuiMetadata¶

Stores GUI metadata about one layout item class.

This is a companion to QgsLayoutItemAbstractMetadata, storing only the components related to the GUI behavior of a layout item.

Note

In C++ you can use QgsLayoutItemGuiMetadata convenience class.

Methods

`createItem`	Creates an instance of the corresponding item type.
`createItemWidget`	Creates a configuration widget for an item of this type.
`createNodeRubberBand`	Creates a rubber band for use when creating layout node based items of this type.
`createRubberBand`	Creates a rubber band for use when creating layout items of this type.
`creationIcon`	Returns an icon representing creation of the layout item type.
`flags`	Returns item flags.
`groupId`	Returns the item group ID, if set.
`isNodeBased`	Returns `True` if the associated item is a node based item.
`newItemAddedToLayout`	Called when a newly created item of the associated type has been added to a layout.
`type`	Returns the unique item type code for the layout item class.
`visibleName`	Returns a translated, user visible name identifying the corresponding layout item.

Attributes

FlagNoCreationTools

class qgis.gui.QgsLayoutItemAbstractGuiMetadata[source]¶

Bases: object

__init__(type: int, visibleName: str | None, groupId: str | None = '', isNodeBased: bool = False, flags: QgsLayoutItemAbstractGuiMetadata.Flags | QgsLayoutItemAbstractGuiMetadata.Flag = QgsLayoutItemAbstractGuiMetadata.Flags())

Constructor for QgsLayoutItemAbstractGuiMetadata with the specified class type.

visibleName should be set to a translated, user visible name identifying the corresponding layout item.

An optional groupId can be set, which allows grouping of related layout item classes. See QgsLayoutItemGuiMetadata for details.

If isNodeBased is True, then the corresponding item is a node based item.

Parameters:

type (int)
visibleName (Optional[str])
groupId (Optional[str] = '')
isNodeBased (bool = False)
flags (Union[QgsLayoutItemAbstractGuiMetadata.Flags, QgsLayoutItemAbstractGuiMetadata.Flag] = QgsLayoutItemAbstractGuiMetadata.Flags())

__init__(a0: QgsLayoutItemAbstractGuiMetadata)

Parameters:: a0 (QgsLayoutItemAbstractGuiMetadata)

class Flag¶: Bases: int

FlagNoCreationTools = 2¶

class Flags¶
class Flags(f: QgsLayoutItemAbstractGuiMetadata.Flags | QgsLayoutItemAbstractGuiMetadata.Flag)
class Flags(a0: QgsLayoutItemAbstractGuiMetadata.Flags): Bases: object

createItem(self, layout: QgsLayout | None) → QgsLayoutItem | None[source]¶

Creates an instance of the corresponding item type.

Parameters:: layout (Optional[QgsLayout])
Return type:: Optional[QgsLayoutItem]

createItemWidget(self, item: QgsLayoutItem | None) → QgsLayoutItemBaseWidget | None[source]¶

Creates a configuration widget for an item of this type. Can return None if no configuration GUI is required.

Parameters:: item (Optional[QgsLayoutItem])
Return type:: Optional[QgsLayoutItemBaseWidget]

createNodeRubberBand(self, view: QgsLayoutView | None) → QAbstractGraphicsShapeItem | None[source]¶

Creates a rubber band for use when creating layout node based items of this type. Can return None if no rubber band should be created. The default behavior is to return None.