QgsActionManager Class Reference

Storage and management of actions associated with a layer. More...

#include <qgsactionmanager.h>

Inheritance diagram for QgsActionManager:

Public Member Functions
	QgsActionManager (QgsVectorLayer *layer)
	Constructor.
QgsAction	action (const QString &id) const
	Gets an action by its id.
QgsAction	action (QUuid id) const
	Gets an action by its id.
QList< QgsAction >	actions (const QString &actionScope=QString()) const
	Returns a list of actions that are available in the given action scope.
void	addAction (const QgsAction &action)
	Add a new action to this list.
QUuid	addAction (Qgis::AttributeActionType type, const QString &name, const QString &command, bool capture=false)
	Add an action with the given name and action details.
QUuid	addAction (Qgis::AttributeActionType type, const QString &name, const QString &command, const QString &icon, bool capture=false)
	Add an action with the given name and action details.
void	clearActions ()
	Removes all actions.
QgsAction	defaultAction (const QString &actionScope)
	Each scope can have a default action.
void	doAction (QUuid actionId, const QgsFeature &feature, const QgsExpressionContext &context)
	Does the action using the expression engine to replace any embedded expressions in the action definition.
void	doAction (QUuid actionId, const QgsFeature &feature, int defaultValueIndex=0, const QgsExpressionContextScope &scope=QgsExpressionContextScope())
	Does the given action.
QgsVectorLayer *	layer () const
	Returns the layer.
bool	readXml (const QDomNode &layer_node, const QgsReadWriteContext &context=QgsReadWriteContext())
	Reads the actions in in XML format.
void	removeAction (QUuid actionId)
	Remove an action by its id.
void	setDefaultAction (const QString &actionScope, QUuid actionId)
	Each scope can have a default action.
bool	writeXml (QDomNode &layer_node) const
	Writes the actions out in XML format.

Detailed Description

Storage and management of actions associated with a layer.

Actions can trigger custom code or applications to be executed based on attributes of a given feature.

Definition at line 51 of file qgsactionmanager.h.

Constructor & Destructor Documentation

QgsActionManager()

QgsActionManager::QgsActionManager

(

QgsVectorLayer *

layer

)

Constructor.

Definition at line 50 of file qgsactionmanager.cpp.

Member Function Documentation

action() [1/2]

QgsAction QgsActionManager::action

(

const QString &

id

)

const

Gets an action by its id.

Since

QGIS 3.28

Definition at line 300 of file qgsactionmanager.cpp.

action() [2/2]

QgsAction QgsActionManager::action

(

QUuid

id

)

const

Gets an action by its id.

Definition at line 289 of file qgsactionmanager.cpp.

actions()

QList< QgsAction > QgsActionManager::actions

(

const QString &

actionScope = QString()

)

const

Returns a list of actions that are available in the given action scope.

If no action scope is provided, all actions will be returned.

Definition at line 180 of file qgsactionmanager.cpp.

addAction() [1/3]

void QgsActionManager::addAction

(

const QgsAction &

action

)

Add a new action to this list.

Definition at line 68 of file qgsactionmanager.cpp.

addAction() [2/3]

QUuid QgsActionManager::addAction	(	Qgis::AttributeActionType	type,
		const QString &	name,
		const QString &	command,
		bool	capture = false )

Add an action with the given name and action details.

Will happily have duplicate names and actions. If capture is true, when running the action using doAction(), any stdout from the process will be captured and displayed in a dialog box.

Definition at line 54 of file qgsactionmanager.cpp.

addAction() [3/3]

QUuid QgsActionManager::addAction	(	Qgis::AttributeActionType	type,
		const QString &	name,
		const QString &	command,
		const QString &	icon,
		bool	capture = false )

Add an action with the given name and action details.

Will happily have duplicate names and actions. If capture is true, when running the action using doAction(), any stdout from the process will be captured and displayed in a dialog box.

Definition at line 61 of file qgsactionmanager.cpp.

clearActions()

void QgsActionManager::clearActions

(

)

Removes all actions.

Definition at line 168 of file qgsactionmanager.cpp.

defaultAction()

QgsAction QgsActionManager::defaultAction

(

const QString &

actionScope

)

Each scope can have a default action.

This will be saved in the project file.

Definition at line 316 of file qgsactionmanager.cpp.

doAction() [1/2]

void QgsActionManager::doAction	(	QUuid	actionId,
		const QgsFeature &	feature,
		const QgsExpressionContext &	context )

Does the action using the expression engine to replace any embedded expressions in the action definition.

Parameters

actionId	action id
feature	feature to run action for
context	expression context to evaluate expressions under

Definition at line 147 of file qgsactionmanager.cpp.

doAction() [2/2]

void QgsActionManager::doAction	(	QUuid	actionId,
		const QgsFeature &	feature,
		int	defaultValueIndex = 0,
		const QgsExpressionContextScope &	scope = QgsExpressionContextScope() )

Does the given action.

Parameters

actionId	action id
feature	feature to run action for
defaultValueIndex	index of the field to be used if the action has a $currfield placeholder.
scope	expression context scope to add during expression evaluation

Note

available in Python bindings as doActionFeature

Definition at line 135 of file qgsactionmanager.cpp.

layer()

QgsVectorLayer * QgsActionManager::layer ( ) const

inline

Returns the layer.

Definition at line 120 of file qgsactionmanager.h.

readXml()

bool QgsActionManager::readXml	(	const QDomNode &	layer_node,
		const QgsReadWriteContext &	context = QgsReadWriteContext() )

Reads the actions in in XML format.

Parameters

layer_node	the layer's xml node
context	The readwrite context (Since QGIS 4.0)

Definition at line 262 of file qgsactionmanager.cpp.

removeAction()

void QgsActionManager::removeAction

(

QUuid

actionId

)

Remove an action by its id.

Definition at line 107 of file qgsactionmanager.cpp.

setDefaultAction()

void QgsActionManager::setDefaultAction	(	const QString &	actionScope,
		QUuid	actionId )

Each scope can have a default action.

This will be saved in the project file.

Definition at line 311 of file qgsactionmanager.cpp.

writeXml()

bool QgsActionManager::writeXml

(

QDomNode &

layer_node

)

const

Writes the actions out in XML format.

Definition at line 242 of file qgsactionmanager.cpp.

---

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

• /build/qgis-3.99.0+git20260128+d270888f95f+99sid/src/core/actions/qgsactionmanager.h
• /build/qgis-3.99.0+git20260128+d270888f95f+99sid/src/core/actions/qgsactionmanager.cpp