Convenience metadata class that uses static functions to handle annotation item GUI behavior. More...

#include <qgsannotationitemguiregistry.h>

Inheritance diagram for QgsAnnotationItemGuiMetadata:

Public Member Functions
	QgsAnnotationItemGuiMetadata (const QString &type, const QString &visibleName, const QIcon &creationIcon, const QgsAnnotationItemWidgetFunc &pfWidget=nullptr, const QString &groupId=QString(), Qgis::AnnotationItemGuiFlags flags=Qgis::AnnotationItemGuiFlags(), const QgsAnnotationItemCreateFunc &pfCreateFunc=nullptr, const QgsCreateAnnotationItemMapToolFunc &pfCreateMapToolFunc=nullptr)
	Constructor for QgsAnnotationItemGuiMetadata with the specified class type and creationIcon, and function pointers for the various configuration widget creation functions.

QgsAnnotationItem *	createItem () override
	Creates an instance of the corresponding item type.

QgsAnnotationItemBaseWidget *	createItemWidget (QgsAnnotationItem *item) override
	Creates a configuration widget for an item of this type.

QgsCreateAnnotationItemMapToolInterface *	createMapTool (QgsMapCanvas canvas, QgsAdvancedDigitizingDockWidget cadDockWidget) override
	Creates a map tool for a creating a new item of this type.

QgsCreateAnnotationItemMapToolFunc	createMapToolFunction () const
	Returns the classes' create new item map tool creation function.

QIcon	creationIcon () const override
	Returns an icon representing creation of the annotation item type.

QgsAnnotationItemAddedToLayerFunc	itemAddToLayerFunction () const
	Returns the classes' item added to layer function.

QgsAnnotationItemCreateFunc	itemCreationFunction () const
	Returns the classes' item creation function.

void	newItemAddedToLayer (QgsAnnotationItem item, QgsAnnotationLayer layer) override
	Called when a newly created item of the associated type has been added to a layer.

void	setCreateMapToolFunction (const QgsCreateAnnotationItemMapToolFunc &function)
	Sets the classes' create new item map tool creation function.

void	setItemAddedToLayerFunction (const QgsAnnotationItemAddedToLayerFunc &function)
	Sets the classes' item creation function.

void	setItemCreationFunction (const QgsAnnotationItemCreateFunc &function)
	Sets the classes' item creation function.

void	setWidgetFunction (const QgsAnnotationItemWidgetFunc &function)
	Sets the classes' configuration widget creation function.

QgsAnnotationItemWidgetFunc	widgetFunction () const
	Returns the classes' configuration widget creation function.

Public Member Functions inherited from QgsAnnotationItemAbstractGuiMetadata
	QgsAnnotationItemAbstractGuiMetadata (const QString &type, const QString &visibleName, const QString &groupId=QString(), Qgis::AnnotationItemGuiFlags flags=Qgis::AnnotationItemGuiFlags())
	Constructor for QgsAnnotationItemAbstractGuiMetadata with the specified class type.

virtual	~QgsAnnotationItemAbstractGuiMetadata ()=default

Qgis::AnnotationItemGuiFlags	flags () const
	Returns item flags.

QString	groupId () const
	Returns the item group ID, if set.

QString	type () const
	Returns the unique item type code for the annotation item class.

QString	visibleName () const
	Returns a translated, user visible name identifying the corresponding annotation item.

Protected Attributes
QgsAnnotationItemAddedToLayerFunc	mAddedToLayerFunc = nullptr

QgsAnnotationItemCreateFunc	mCreateFunc = nullptr

QgsCreateAnnotationItemMapToolFunc	mCreateMapToolFunc = nullptr

QIcon	mIcon

QgsAnnotationItemWidgetFunc	mWidgetFunc = nullptr

Detailed Description

Convenience metadata class that uses static functions to handle annotation item GUI behavior.

Note: not available in Python bindings

Since: QGIS 3.22

Definition at line 156 of file qgsannotationitemguiregistry.h.

Constructor & Destructor Documentation

◆ QgsAnnotationItemGuiMetadata()

QgsAnnotationItemGuiMetadata::QgsAnnotationItemGuiMetadata	(	const QString &	type,
		const QString &	visibleName,
		const QIcon &	creationIcon,
		const QgsAnnotationItemWidgetFunc &	pfWidget = `nullptr`,
		const QString &	groupId = `QString()`,
		Qgis::AnnotationItemGuiFlags	flags = `Qgis::AnnotationItemGuiFlags()`,
		const QgsAnnotationItemCreateFunc &	pfCreateFunc = `nullptr`,
		const QgsCreateAnnotationItemMapToolFunc &	pfCreateMapToolFunc = `nullptr`
	)

inline

Constructor for QgsAnnotationItemGuiMetadata with the specified class type and creationIcon, and function pointers for the various configuration widget creation functions.

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

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

Definition at line 169 of file qgsannotationitemguiregistry.h.

Member Function Documentation

◆ createItem()

QgsAnnotationItem * QgsAnnotationItemGuiMetadata::createItem ( )

overridevirtual

Creates an instance of the corresponding item type.

Reimplemented from QgsAnnotationItemAbstractGuiMetadata.

Definition at line 66 of file qgsannotationitemguiregistry.cpp.

◆ createItemWidget()

QgsAnnotationItemBaseWidget * QgsAnnotationItemGuiMetadata::createItemWidget ( QgsAnnotationItem * item )

overridevirtual

Creates a configuration widget for an item of this type.

Can return nullptr if no configuration GUI is required.

Reimplemented from QgsAnnotationItemAbstractGuiMetadata.

Definition at line 61 of file qgsannotationitemguiregistry.cpp.

◆ createMapTool()

QgsCreateAnnotationItemMapToolInterface * QgsAnnotationItemGuiMetadata::createMapTool	(	QgsMapCanvas *	canvas,
		QgsAdvancedDigitizingDockWidget *	cadDockWidget
	)