Inheritance diagram for Digikam::ReplaceModifier:

Public Types
enum	IconType { Action = 0 , Dialog }

Signals
void	signalTokenTriggered (const QString &)

Public Member Functions
QString	description () const

QPixmap	icon (Rule::IconType type=Rule::Action) const

bool	isValid () const

ParseResults	parse (ParseSettings &settings)

QString	parseOperation (ParseSettings &settings, const QRegularExpressionMatch &match) override

QRegularExpression &	regExp () const

QPushButton *	registerButton (QWidget *parent)

QAction *	registerMenu (QMenu *parent)

	ReplaceModifier ()

virtual void	reset ()

TokenList &	tokens () const

bool	useTokenMenu () const

Static Public Member Functions
static QString	escapeToken (const QString &token)

Protected Member Functions
bool	addToken (const QString &id, const QString &description, const QString &actionName=QString())

void	setDescription (const QString &desc)

void	setIcon (const QString &pixmap)

void	setRegExp (const QRegularExpression &regExp)

void	setUseTokenMenu (bool value)

Member Enumeration Documentation

◆ IconType

enum Digikam::Rule::IconType

inherited

Enumerator
Action
Dialog

Constructor & Destructor Documentation

◆ ReplaceModifier()

Digikam::ReplaceModifier::ReplaceModifier ( )

explicit

References Digikam::Rule::addToken(), and Digikam::Rule::setRegExp().

Member Function Documentation

◆ addToken()

bool Digikam::Rule::addToken	(	const QString &	id,
		const QString &	description,
		const QString &	actionName = `QString()`
	)

protectedinherited

add a token to the parser, every parser should at least assign one token object

Parameters

id	the token id string (used for parsing)
description	the description of the token (used for example in the tooltip)
actionName	[optional] the name of the token action (only used when the token menu is displayed)

Returns

References Digikam::Token::action(), Digikam::Rule::description(), Digikam::Rule::signalTokenTriggered(), and Digikam::Rule::slotTokenTriggered().

Referenced by Digikam::CameraNameOption::CameraNameOption(), Digikam::CaseModifier::CaseModifier(), Digikam::DatabaseOption::DatabaseOption(), Digikam::DateOption::DateOption(), Digikam::DefaultValueModifier::DefaultValueModifier(), Digikam::DirectoryNameOption::DirectoryNameOption(), Digikam::FilePropertiesOption::FilePropertiesOption(), Digikam::MetadataOption::MetadataOption(), Digikam::RangeModifier::RangeModifier(), Digikam::RemoveDoublesModifier::RemoveDoublesModifier(), ReplaceModifier(), Digikam::SequenceNumberOption::SequenceNumberOption(), Digikam::TrimmedModifier::TrimmedModifier(), and Digikam::UniqueModifier::UniqueModifier().

◆ description()

QString Digikam::Rule::description ( ) const

inherited

Referenced by Digikam::Rule::addToken(), Digikam::DefaultValueModifier::DefaultValueModifier(), Digikam::MetadataOption::MetadataOption(), Digikam::Modifier::Modifier(), Digikam::Option::Option(), Digikam::RemoveDoublesModifier::RemoveDoublesModifier(), Digikam::RuleDialog::RuleDialog(), Digikam::TrimmedModifier::TrimmedModifier(), and Digikam::UniqueModifier::UniqueModifier().

◆ escapeToken()

QString Digikam::Rule::escapeToken ( const QString & token )

staticinherited

Escape the token characters to make them work in regular expressions

Parameters

token the token to be escaped

Returns: A token with escaped characters. This token can then be used in a regular expression

Referenced by Digikam::CameraNameOption::CameraNameOption(), Digikam::FilePropertiesOption::FilePropertiesOption(), and Digikam::TrimmedModifier::TrimmedModifier().

◆ icon()

QPixmap Digikam::Rule::icon ( Rule::IconType type = Rule::Action ) const

inherited

References Digikam::Rule::Dialog.

Referenced by Digikam::MetadataOption::MetadataOption(), Digikam::Rule::registerButton(), Digikam::Rule::registerMenu(), Digikam::Rule::Rule(), and Digikam::RuleDialog::RuleDialog().

◆ isValid()

bool Digikam::Rule::isValid ( ) const

inherited

Checks the validity of the parse object

Returns: true if valid

Referenced by Digikam::Parser::registerModifier(), and Digikam::Parser::registerOption().

◆ parse()

ParseResults Digikam::Rule::parse ( ParseSettings & settings )

inherited

References Digikam::ParseResults::addEntry(), Digikam::Rule::parseOperation(), Digikam::ParseSettings::parseString, and Digikam::Rule::regExp().

Referenced by Digikam::Parser::parse().

◆ parseOperation()

QString Digikam::ReplaceModifier::parseOperation	(	ParseSettings &	settings,
		const QRegularExpressionMatch &	match
	)

overridevirtual

TODO: describe me

Parameters

settings	contains settings
match	result of the regular expression match done in Option::parse()

Returns

Implements Digikam::Modifier.

References Digikam::ParseSettings::str2Modify.

◆ regExp()

QRegularExpression & Digikam::Rule::regExp ( ) const

inherited

TODO: This is probably not needed anymore. Find out. returns the currently assigned regExp object. Note that it is returned as a const ref, meaning that if you use it in your custom parse operation, the main parse method has already searched for the pattern and filled in the results of this search, so that you can use QRegularExpressionMatch::captured() immediately, you don't have to search on your own.

For example when implementing the Option::parseOperation() method, get the regExp object with

 const QRegularExpression& reg = regExp();

and immediately fetch possible matches with

 const QString& param1 = reg.captured(1);

See also: Option; Modifier

Returns: a const ref to the assigned regexp object

Referenced by Digikam::Parser::parse(), Digikam::Rule::parse(), and Digikam::Rule::setRegExp().

◆ registerButton()

QPushButton * Digikam::Rule::registerButton ( QWidget * parent )

inherited

Register a button in the parent object. By calling this method, a new button for the parser object will be created and all necessary connections will be setup.

Parameters

parent the parent object the button will be registered for

Returns: a pointer to the newly created button

References Digikam::Token::action(), and Digikam::Rule::icon().

◆ registerMenu()

QAction * Digikam::Rule::registerMenu ( QMenu * parent )

inherited

Register a menu action in the parent object. By calling this method, a new action for the parser object will be created and all necessary connections will be setup.

Parameters

parent the parent object the action will be registered for

Returns: a pointer to the newly created action

References Digikam::Token::action(), and Digikam::Rule::icon().

◆ reset()

void Digikam::Rule::reset ( )

virtualinherited

Resets the parser to its initial state

Reimplemented in Digikam::UniqueModifier.

Referenced by Digikam::Parser::reset().

◆ setDescription()

void Digikam::Rule::setDescription ( const QString & desc )

protectedinherited

Referenced by Digikam::Modifier::Modifier(), and Digikam::Option::Option().

◆ setIcon()

void Digikam::Rule::setIcon ( const QString & pixmap )

protectedinherited

Referenced by Digikam::MetadataOption::MetadataOption(), and Digikam::Rule::Rule().

◆ setRegExp()

void Digikam::Rule::setRegExp ( const QRegularExpression & regExp )

protectedinherited

References Digikam::Rule::regExp().

Referenced by Digikam::CameraNameOption::CameraNameOption(), Digikam::CaseModifier::CaseModifier(), Digikam::DatabaseOption::DatabaseOption(), Digikam::DateOption::DateOption(), Digikam::DefaultValueModifier::DefaultValueModifier(), Digikam::DirectoryNameOption::DirectoryNameOption(), Digikam::FilePropertiesOption::FilePropertiesOption(), Digikam::MetadataOption::MetadataOption(), Digikam::RangeModifier::RangeModifier(), Digikam::RemoveDoublesModifier::RemoveDoublesModifier(), ReplaceModifier(), Digikam::SequenceNumberOption::SequenceNumberOption(), Digikam::TrimmedModifier::TrimmedModifier(), and Digikam::UniqueModifier::UniqueModifier().

◆ setUseTokenMenu()

void Digikam::Rule::setUseTokenMenu ( bool value )

protectedinherited

If multiple tokens have been assigned to a rule, a menu will be created. If you want to display a menu for every defined token, set this method to 'true' and re-implement the

See also: slotTokenTriggered method.

Parameters

value boolean parameter to set token menu usage

References value.

Referenced by Digikam::CaseModifier::CaseModifier(), and Digikam::FilePropertiesOption::FilePropertiesOption().

◆ signalTokenTriggered

void Digikam::Rule::signalTokenTriggered ( const QString & )

signalinherited

Referenced by Digikam::Rule::addToken(), and Digikam::Rule::slotTokenTriggered().

◆ tokens()

TokenList & Digikam::Rule::tokens ( ) const

inherited

Returns: a list of all registered tokens

◆ useTokenMenu()

bool Digikam::Rule::useTokenMenu ( ) const

inherited

Returns true if a token menu is used.

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

core/utilities/advancedrename/parser/modifiers/replacemodifier.h
core/utilities/advancedrename/parser/modifiers/replacemodifier.cpp

Public Types

Signals

Public Member Functions

Static Public Member Functions

Protected Member Functions

Member Enumeration Documentation

◆ IconType

Constructor & Destructor Documentation

◆ ReplaceModifier()

Member Function Documentation

◆ addToken()

◆ description()

◆ escapeToken()

◆ icon()

◆ isValid()

◆ parse()

◆ parseOperation()

◆ regExp()

◆ registerButton()

◆ registerMenu()

◆ reset()

◆ setDescription()

◆ setIcon()

◆ setRegExp()

◆ setUseTokenMenu()

◆ signalTokenTriggered

◆ tokens()

◆ useTokenMenu()