The KoShapeMergeTextPropertiesCommand class This sets text properties on given text shapes. For setting text on range, see SvgTextMergePropertiesRangeCommand. More...

#include <KoShapeMergeTextPropertiesCommand.h>

Inheritance diagram for KoShapeMergeTextPropertiesCommand:

Classes
struct	Private

Public Member Functions
int	id () const override

	KoShapeMergeTextPropertiesCommand (const QList< KoShape * > &shapes, const KoSvgTextProperties &props, const QSet< KoSvgTextProperties::PropertyId > removeProperties=QSet< KoSvgTextProperties::PropertyId >(), KUndo2Command *parent=nullptr)

bool	mergeWith (const KUndo2Command *command) override

void	redo () override

void	undo () override

	~KoShapeMergeTextPropertiesCommand ()=default

Public Member Functions inherited from KUndo2Command
QString	actionText () const

virtual bool	canAnnihilateWith (const KUndo2Command *other) const

const KUndo2Command *	child (int index) const

int	childCount () const

virtual QTime	endTime () const

KUndo2CommandExtraData *	extraData () const

bool	hasParent () const

virtual bool	isMerged () const

	KUndo2Command (const KUndo2MagicString &text, KUndo2Command *parent=0)

	KUndo2Command (KUndo2Command *parent=0)

virtual QVector< KUndo2Command * >	mergeCommandsVector () const

virtual void	redoMergedCommands ()

void	setEndTime ()

virtual void	setEndTime (const QTime &time)

void	setExtraData (KUndo2CommandExtraData *data)

void	setText (const KUndo2MagicString &text)

void	setTime ()

virtual void	setTime (const QTime &time)

virtual void	setTimedID (int timedID)

KUndo2MagicString	text () const

virtual QTime	time () const

virtual int	timedId () const

virtual bool	timedMergeWith (KUndo2Command *other)

virtual void	undoMergedCommands ()

virtual	~KUndo2Command ()

Private Attributes
QScopedPointer< Private >	d

Detailed Description

The KoShapeMergeTextPropertiesCommand class This sets text properties on given text shapes. For setting text on range, see SvgTextMergePropertiesRangeCommand.

Definition at line 21 of file KoShapeMergeTextPropertiesCommand.h.

Constructor & Destructor Documentation

◆ KoShapeMergeTextPropertiesCommand()

KoShapeMergeTextPropertiesCommand::KoShapeMergeTextPropertiesCommand	(	const QList< KoShape * > &	shapes,
		const KoSvgTextProperties &	props,
		const QSet< KoSvgTextProperties::PropertyId >	removeProperties = QSet<KoSvgTextProperties::PropertyId>(),
		KUndo2Command *	parent = nullptr )

Definition at line 22 of file KoShapeMergeTextPropertiesCommand.cpp.

    : KUndo2Command(parent),
    d(new Private(shapes))
{
    setText(kundo2_i18n("Change Text Shape Properties"));
    d->newProperties = props;
    d->removeProperties = removeProperties;
}

References d, kundo2_i18n(), and KUndo2Command::setText().

◆ ~KoShapeMergeTextPropertiesCommand()

KoShapeMergeTextPropertiesCommand::~KoShapeMergeTextPropertiesCommand ( )

default

Member Function Documentation

◆ id()

int KoShapeMergeTextPropertiesCommand::id ( ) const

overridevirtual

Returns the ID of this command.

A command ID is used in command compression. It must be an integer unique to this command's class, or -1 if the command doesn't support compression.

If the command supports compression this function must be overridden in the derived class to return the correct ID. The base implementation returns -1.

KUndo2QStack::push() will only try to merge two commands if they have the same ID, and the ID is not -1.

See also: mergeWith(), KUndo2QStack::push()

Reimplemented from KUndo2Command.

Definition at line 57 of file KoShapeMergeTextPropertiesCommand.cpp.

{
    return KisCommandUtils::KoShapeMergeTextPropertiesCommandId;
}

References KisCommandUtils::KoShapeMergeTextPropertiesCommandId.

◆ mergeWith()

bool KoShapeMergeTextPropertiesCommand::mergeWith ( const KUndo2Command * command )

overridevirtual

Attempts to merge this command with command. Returns true on success; otherwise returns false.

If this function returns true, calling this command's redo() must have the same effect as redoing both this command and command. Similarly, calling this command's undo() must have the same effect as undoing command and this command.

KUndo2QStack will only try to merge two commands if they have the same id, and the id is not -1.

The default implementation returns false.

See also: id() KUndo2QStack::push()

The merging algorithm should follow the ordering of KoSvgTextShape::mergePropertiesIntoRange, that is, firstly, the properties in removeProperties list are removed, then properties in properties are applied. If the property is present in both lists, then the value from properties is used.

Reimplemented from KUndo2Command.

Definition at line 62 of file KoShapeMergeTextPropertiesCommand.cpp.

{
    const KoShapeMergeTextPropertiesCommand *command = dynamic_cast<const KoShapeMergeTextPropertiesCommand*>(other);
 
    if (!command || !KritaUtils::compareListsUnordered(command->d->shapes, d->shapes)) {
        return false;
    }
 
    Q_FOREACH(KoSvgTextProperties::PropertyId p, command->d->removeProperties) {
        d->newProperties.removeProperty(p);
        d->removeProperties.insert(p);
    }
 
    Q_FOREACH(KoSvgTextProperties::PropertyId p, command->d->newProperties.properties()) {
        d->newProperties.setProperty(p, command->d->newProperties.property(p));
        d->removeProperties.remove(p);
    }
 
    return true;
}

References KritaUtils::compareListsUnordered(), d, and p.

◆ redo()

void KoShapeMergeTextPropertiesCommand::redo ( )

overridevirtual

Applies a change to the document. This function must be implemented in the derived class. Calling KUndo2QStack::push(), KUndo2QStack::undo() or KUndo2QStack::redo() from this function leads to undefined behavior.

The default implementation calls redo() on all child commands.

See also: undo()

Reimplemented from KUndo2Command.

Definition at line 31 of file KoShapeMergeTextPropertiesCommand.cpp.

{
    for(auto it = d->shapes.begin(); it!= d->shapes.end(); it++) {
        KoSvgTextShape *shape = dynamic_cast<KoSvgTextShape*>(*it);
        if (shape) {
            d->mementos.insert(*it, shape->getMemento());
            const QRectF oldDirtyRect = shape->boundingRect();
            shape->mergePropertiesIntoRange(-1, -1, d->newProperties, d->removeProperties);
            shape->updateAbsolute(oldDirtyRect | shape->boundingRect());
        }
    }
}

References KoSvgTextShape::boundingRect(), d, KoSvgTextShape::getMemento(), KoSvgTextShape::mergePropertiesIntoRange(), and KoShape::updateAbsolute().

◆ undo()

void KoShapeMergeTextPropertiesCommand::undo ( )

overridevirtual

Reverts a change to the document. After undo() is called, the state of the document should be the same as before redo() was called. This function must be implemented in the derived class. Calling KUndo2QStack::push(), KUndo2QStack::undo() or KUndo2QStack::redo() from this function leads to undefined behavior.

The default implementation calls undo() on all child commands in reverse order.

See also: redo()

Reimplemented from KUndo2Command.

Definition at line 44 of file KoShapeMergeTextPropertiesCommand.cpp.

{
    for(auto it = d->shapes.begin(); it!= d->shapes.end(); it++) {
        KoSvgTextShape *shape = dynamic_cast<KoSvgTextShape*>(*it);
        if (shape && d->mementos.contains(*it)) {
            const QRectF oldDirtyRect = shape->boundingRect();
            shape->setMemento(d->mementos.value(*it));
            shape->updateAbsolute(oldDirtyRect | shape->boundingRect());
        }
    }
    d->mementos.clear();
}