Utility class that encapsulates an action based on vector attributes. More...

#include <qgsaction.h>

Public Types
enum	ActionType { Generic , GenericPython , Mac , Windows , Unix , OpenUrl , SubmitUrlEncoded , SubmitUrlMultipart }

Public Member Functions
	QgsAction ()=default
	Default constructor. More...

	QgsAction (ActionType type, const QString &description, const QString &action, const QString &icon, bool capture, const QString &shortTitle=QString(), const QSet< QString > &actionScopes=QSet< QString >(), const QString &notificationMessage=QString(), bool enabledOnlyWhenEditable=false)
	Create a new QgsAction. More...

	QgsAction (ActionType type, const QString &description, const QString &command, bool capture=false, bool enabledOnlyWhenEditable=false)
	Create a new QgsAction. More...

	QgsAction (const QUuid &id, ActionType type, const QString &description, const QString &action, const QString &icon, bool capture, const QString &shortTitle=QString(), const QSet< QString > &actionScopes=QSet< QString >(), const QString &notificationMessage=QString(), bool enabledOnlyWhenEditable=false)
	Create a new QgsAction. More...

QSet< QString >	actionScopes () const
	The action scopes define where an action will be available. More...

bool	capture () const
	Whether to capture output for display when this action is run. More...

QString	command () const
	Returns the command that is executed by this action. More...

QgsExpressionContextScope	expressionContextScope () const
	Returns an expression context scope used for running the action. More...

QString	html () const
	Returns an HTML table with the basic information about this action. More...

QIcon	icon () const
	The icon. More...

QString	iconPath () const
	The path to the icon. More...

QUuid	id () const
	Returns a unique id for this action. More...

bool	isEnabledOnlyWhenEditable () const
	Returns whether only enabled in editable mode. More...

bool	isValid () const
	Returns `true` if this action was a default constructed one. More...

QString	name () const
	The name of the action. This may be a longer description. More...

QString	notificationMessage () const
	Returns the notification message that triggers the action. More...

void	readXml (const QDomNode &actionNode)
	Reads an XML definition from actionNode into this object. More...

void	run (const QgsExpressionContext &expressionContext) const
	Run this action. More...

void	run (QgsVectorLayer *layer, const QgsFeature &feature, const QgsExpressionContext &expressionContext) const
	Run this action. More...

bool	runable () const
	Checks if the action is runable on the current platform. More...

void	setActionScopes (const QSet< QString > &actionScopes)
	The action scopes define where an action will be available. More...

void	setCommand (const QString &newCommand)
	Sets the action command. More...

void	setEnabledOnlyWhenEditable (bool enable)
	Set whether the action is only enabled in editable mode. More...

void	setExpressionContextScope (const QgsExpressionContextScope &scope)
	Sets an expression context scope to use for running the action. More...

QString	shortTitle () const
	The short title is used to label user interface elements like buttons. More...

ActionType	type () const
	The action type. More...

void	writeXml (QDomNode &actionsNode) const
	Appends an XML definition for this action as a new child node to actionsNode. More...

Detailed Description

Utility class that encapsulates an action based on vector attributes.

Definition at line 34 of file qgsaction.h.

Member Enumeration Documentation

◆ ActionType

enum QgsAction::ActionType

Enumerator
Generic
GenericPython
Mac
Windows
Unix
OpenUrl
SubmitUrlEncoded	POST data to an URL, using "application/x-www-form-urlencoded" or "application/json" if the body is valid JSON. Since QGIS 3.24
SubmitUrlMultipart	POST data to an URL using "multipart/form-data". Since QGIS 3.24

Definition at line 37 of file qgsaction.h.

Constructor & Destructor Documentation

◆ QgsAction() [1/4]

QgsAction::QgsAction ( )

default

Default constructor.

◆ QgsAction() [2/4]

QgsAction::QgsAction	(	ActionType	type,
		const QString &	description,
		const QString &	command,
		bool	capture = `false`,
		bool	enabledOnlyWhenEditable = `false`
	)

inline

Create a new QgsAction.

Parameters

type	The type of this action
description	A human readable description string
command	The action text. Its interpretation depends on the type
capture	If this is set to `true`, the output will be captured when an action is run
enabledOnlyWhenEditable	if `true` then action is only enable in editmode. Not available in Python bindings.

Definition at line 63 of file qgsaction.h.

◆ QgsAction() [3/4]

QgsAction::QgsAction	(	ActionType	type,
		const QString &	description,
		const QString &	action,
		const QString &	icon,
		bool	capture,
		const QString &	shortTitle = `QString()`,
		const QSet< QString > &	actionScopes = `QSet<QString>()`,
		const QString &	notificationMessage = `QString()`,
		bool	enabledOnlyWhenEditable = `false`
	)

inline

Create a new QgsAction.

Parameters

type	The type of this action
description	A human readable description string
action	The action text. Its interpretation depends on the type
icon	Path to an icon for this action
capture	If this is set to `true`, the output will be captured when an action is run
shortTitle	A short string used to label user interface elements like buttons
actionScopes	A set of scopes in which this action will be available
notificationMessage	A particular message which reception will trigger the action
enabledOnlyWhenEditable	if `true` then action is only enable in editmode. Not available in Python bindings.

Definition at line 85 of file qgsaction.h.

◆ QgsAction() [4/4]

QgsAction::QgsAction	(	const QUuid &	id,
		ActionType	type,
		const QString &	description,
		const QString &	action,
		const QString &	icon,
		bool	capture,
		const QString &	shortTitle = `QString()`,
		const QSet< QString > &	actionScopes = `QSet<QString>()`,
		const QString &	notificationMessage = `QString()`,
		bool	enabledOnlyWhenEditable = `false`
	)

inline

Create a new QgsAction.

Parameters

id	The unique identifier of this action
type	The type of this action
description	A human readable description string
action	The action text. Its interpretation depends on the type
icon	Path to an icon for this action
capture	If this is set to `true`, the output will be captured when an action is run
shortTitle	A short string used to label user interface elements like buttons
actionScopes	A set of scopes in which this action will be available
notificationMessage	A particular message which reception will trigger the action
enabledOnlyWhenEditable	if `true` then action is only enable in editmode. Not available in Python bindings.

Definition at line 112 of file qgsaction.h.

Member Function Documentation

◆ actionScopes()

QSet< QString > QgsAction::actionScopes ( ) const

The action scopes define where an action will be available.

Action scopes may offer additional variables like the clicked coordinate.

See also: QgsActionScope

Since: QGIS 3.0

Definition at line 298 of file qgsaction.cpp.

◆ capture()

bool QgsAction::capture ( ) const

inline

Whether to capture output for display when this action is run.

Definition at line 172 of file qgsaction.h.

◆ command()

QString QgsAction::command ( ) const

inline

Returns the command that is executed by this action.

How the content is interpreted depends on the type() and the actionScope().

Since: QGIS 3.0

Definition at line 159 of file qgsaction.h.

◆ expressionContextScope()

QgsExpressionContextScope QgsAction::expressionContextScope ( ) const

Returns an expression context scope used for running the action.

Since: QGIS 3.0

Definition at line 371 of file qgsaction.cpp.

◆ html()

QString QgsAction::html ( ) const

Returns an HTML table with the basic information about this action.

Since: QGIS 3.24

Definition at line 376 of file qgsaction.cpp.

◆ icon()

QIcon QgsAction::icon ( ) const

inline

The icon.

Definition at line 150 of file qgsaction.h.

◆ iconPath()

QString QgsAction::iconPath ( ) const

inline

The path to the icon.

Definition at line 147 of file qgsaction.h.

◆ id()

QUuid QgsAction::id ( ) const

inline

Returns a unique id for this action.

Since: QGIS 3.0

Definition at line 137 of file qgsaction.h.

◆ isEnabledOnlyWhenEditable()

bool QgsAction::isEnabledOnlyWhenEditable ( ) const

inline

Returns whether only enabled in editable mode.

Definition at line 176 of file qgsaction.h.

◆ isValid()

bool QgsAction::isValid ( ) const

inline

Returns true if this action was a default constructed one.

Since: QGIS 3.0

Definition at line 144 of file qgsaction.h.

◆ name()

QString QgsAction::name ( ) const

inline

The name of the action. This may be a longer description.

Definition at line 127 of file qgsaction.h.

◆ notificationMessage()

QString QgsAction::notificationMessage ( ) const

inline

Returns the notification message that triggers the action.

Since: QGIS 3.0

Definition at line 166 of file qgsaction.h.

◆ readXml()

void QgsAction::readXml ( const QDomNode & actionNode )

Reads an XML definition from actionNode into this object.

Since: QGIS 3.0

Definition at line 308 of file qgsaction.cpp.

◆ run() [1/2]

void QgsAction::run ( const QgsExpressionContext & expressionContext ) const

Run this action.

Since: QGIS 3.0

Definition at line 256 of file qgsaction.cpp.

◆ run() [2/2]

void QgsAction::run	(	QgsVectorLayer *	layer,
		const QgsFeature &	feature,
		const QgsExpressionContext &	expressionContext
	)		const

Run this action.

Since: QGIS 3.0

Definition at line 59 of file qgsaction.cpp.

◆ runable()

bool QgsAction::runable ( ) const

Checks if the action is runable on the current platform.

Definition at line 42 of file qgsaction.cpp.

◆ setActionScopes()

void QgsAction::setActionScopes ( const QSet< QString > & actionScopes )

The action scopes define where an action will be available.

Action scopes may offer additional variables like the clicked coordinate.

Since: QGIS 3.0

Definition at line 303 of file qgsaction.cpp.

◆ setCommand()

void QgsAction::setCommand ( const QString & newCommand )

Sets the action command.

Since: QGIS 3.26

Definition at line 251 of file qgsaction.cpp.

◆ setEnabledOnlyWhenEditable()

void QgsAction::setEnabledOnlyWhenEditable ( bool enable )

inline

Set whether the action is only enabled in editable mode.

Since: QGIS 3.16

Definition at line 183 of file qgsaction.h.

◆ setExpressionContextScope()

void QgsAction::setExpressionContextScope ( const QgsExpressionContextScope & scope )

Sets an expression context scope to use for running the action.

Since: QGIS 3.0

Definition at line 366 of file qgsaction.cpp.

◆ shortTitle()

QString QgsAction::shortTitle ( ) const

inline

The short title is used to label user interface elements like buttons.

Definition at line 130 of file qgsaction.h.

◆ type()

ActionType QgsAction::type ( ) const

inline

The action type.

Definition at line 169 of file qgsaction.h.

◆ writeXml()

void QgsAction::writeXml ( QDomNode & actionsNode ) const

Appends an XML definition for this action as a new child node to actionsNode.

Since: QGIS 3.0

Definition at line 342 of file qgsaction.cpp.

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

/build/qgis-3.28.0+99sid/src/core/qgsaction.h
/build/qgis-3.28.0+99sid/src/core/qgsaction.cpp

Public Types

Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ ActionType

Constructor & Destructor Documentation

◆ QgsAction() [1/4]

◆ QgsAction() [2/4]

◆ QgsAction() [3/4]

◆ QgsAction() [4/4]

Member Function Documentation

◆ actionScopes()

◆ capture()

◆ command()

◆ expressionContextScope()

◆ html()

◆ icon()

◆ iconPath()

◆ id()

◆ isEnabledOnlyWhenEditable()

◆ isValid()

◆ name()

◆ notificationMessage()

◆ readXml()

◆ run() [1/2]

◆ run() [2/2]

◆ runable()

◆ setActionScopes()

◆ setCommand()

◆ setEnabledOnlyWhenEditable()

◆ setExpressionContextScope()

◆ shortTitle()

◆ type()

◆ writeXml()