ShapeMoveStrategy Class Reference

#include <ShapeMoveStrategy.h>

Inheritance diagram for ShapeMoveStrategy:

Public Member Functions
KUndo2Command *	createCommand () override
void	finishInteraction (Qt::KeyboardModifiers modifiers) override
void	handleMouseMove (const QPointF &mouseLocation, Qt::KeyboardModifiers modifiers) override
void	paint (QPainter &painter, const KoViewConverter &converter) override
	ShapeMoveStrategy (KoToolBase *tool, KoSelection *selection, const QPointF &clicked)
	~ShapeMoveStrategy () override
Public Member Functions inherited from KoInteractionStrategy
virtual void	cancelInteraction ()
	KoInteractionStrategy (KoToolBase *parent)
	constructor
KoToolBase *	tool () const
virtual	~KoInteractionStrategy ()
	Destructor.

Private Member Functions
void	moveSelection (const QPointF &diff)

Private Attributes
QPointer< KoCanvasBase >	m_canvas
QPointF	m_finalMove
QPointF	m_initialOffset
QList< QPointF >	m_newPositions
QList< QPointF >	m_previousPositions
QList< KoShape * >	m_selectedShapes
QPointF	m_start

Additional Inherited Members
Protected Member Functions inherited from KoInteractionStrategy
uint	decorationThickness () const
uint	grabSensitivity () const
	Convenience function to get the global grab sensitivity.
uint	handleRadius () const
	Convenience function to get the global handle radius.
	KoInteractionStrategy (KoInteractionStrategyPrivate &)
	constructor
Protected Attributes inherited from KoInteractionStrategy
KoInteractionStrategyPrivate *	d_ptr

Detailed Description

Implements the Move action on an object or selected objects.

Definition at line 27 of file ShapeMoveStrategy.h.

Constructor & Destructor Documentation

ShapeMoveStrategy()

ShapeMoveStrategy::ShapeMoveStrategy	(	KoToolBase *	tool,
		KoSelection *	selection,
		const QPointF &	clicked )

Constructor that starts to move the objects.

Parameters

tool	the parent tool which controls this strategy
canvas	the canvas interface which will supply things like a selection object
clicked	the initial point that the user depressed (in pt).

Definition at line 28 of file ShapeMoveStrategy.cpp.

    : KoInteractionStrategy(tool)
    , m_start(clicked)
    , m_canvas(tool->canvas())
{
    QList<KoShape *> selectedShapes = selection->selectedEditableShapes();
 
    Q_FOREACH (KoShape *shape, selectedShapes) {
        m_selectedShapes << shape;
        m_previousPositions << shape->absolutePosition(KoFlake::Center);
        m_newPositions << shape->absolutePosition(KoFlake::Center);
    }
 
    KoFlake::AnchorPosition anchor =
            KoFlake::AnchorPosition(
                m_canvas->resourceManager()->resource(KoFlake::HotPosition).toInt());
 
    m_initialOffset = selection->absolutePosition(anchor) - m_start;
    m_canvas->snapGuide()->setIgnoredShapes(KoShape::linearizeSubtree(m_selectedShapes));
 
    tool->setStatusText(i18n("Press Shift to hold x- or y-position."));
}

References KoShape::absolutePosition(), KoFlake::Center, KoFlake::HotPosition, KoShape::linearizeSubtree(), m_canvas, m_initialOffset, m_newPositions, m_previousPositions, m_selectedShapes, m_start, KoSelection::selectedEditableShapes(), KoToolBase::setStatusText(), and KoInteractionStrategy::tool().

~ShapeMoveStrategy()

ShapeMoveStrategy::~ShapeMoveStrategy ( )

inlineoverride

Definition at line 37 of file ShapeMoveStrategy.h.

{}

Member Function Documentation

createCommand()

KUndo2Command * ShapeMoveStrategy::createCommand ( )

overridevirtual

For interactions that are undo-able this method should be implemented to return such a command. Implementations should return 0 otherwise.

Returns

a command, or 0.

Implements KoInteractionStrategy.

Definition at line 94 of file ShapeMoveStrategy.cpp.

{
    tool()->canvas()->snapGuide()->reset();
    if (m_finalMove.isNull()) {
        return 0;
    }
    return new KoShapeMoveCommand(m_selectedShapes, m_previousPositions, m_newPositions);
}

References KoToolBase::canvas(), m_finalMove, m_newPositions, m_previousPositions, m_selectedShapes, KoSnapGuide::reset(), KoCanvasBase::snapGuide, and KoInteractionStrategy::tool().

finishInteraction()

void ShapeMoveStrategy::finishInteraction ( Qt::KeyboardModifiers modifiers )

overridevirtual

Override to make final changes to the data on the end of an interaction.

Implements KoInteractionStrategy.

Definition at line 103 of file ShapeMoveStrategy.cpp.

{
    Q_UNUSED(modifiers);
}

handleMouseMove()

void ShapeMoveStrategy::handleMouseMove ( const QPointF & mouseLocation, Qt::KeyboardModifiers modifiers )

overridevirtual

Extending classes should implement this method to update the selectedShapes based on the new mouse position.

Parameters

mouseLocation	the new location in pt
modifiers	OR-ed set of keys pressed.

Implements KoInteractionStrategy.

Definition at line 51 of file ShapeMoveStrategy.cpp.

{
    if (m_selectedShapes.isEmpty()) {
        return;
    }
    QPointF diff = point - m_start;
 
    if (modifiers & Qt::ShiftModifier) {
        // Limit change to one direction only
        diff = snapToClosestAxis(diff);
    } else {
        QPointF positionToSnap = point + m_initialOffset;
        QPointF snappedPosition = tool()->canvas()->snapGuide()->snap(positionToSnap, modifiers);
        diff = snappedPosition - m_initialOffset - m_start;
    }
 
    moveSelection(diff);
    m_finalMove = diff;
}

References KoToolBase::canvas(), m_finalMove, m_initialOffset, m_selectedShapes, m_start, moveSelection(), KoSnapGuide::snap(), KoCanvasBase::snapGuide, snapToClosestAxis(), and KoInteractionStrategy::tool().

moveSelection()

void ShapeMoveStrategy::moveSelection ( const QPointF & diff )

private

Definition at line 71 of file ShapeMoveStrategy.cpp.

{
    Q_ASSERT(m_newPositions.count());
 
    KoShapeBulkActionLock lock(m_selectedShapes);
 
    int i = 0;
    Q_FOREACH (KoShape *shape, m_selectedShapes) {
        QPointF delta = m_previousPositions.at(i) + diff - shape->absolutePosition(KoFlake::Center);
        if (shape->parent()) {
            shape->parent()->model()->proposeMove(shape, delta);
        }
        tool()->canvas()->clipToDocument(shape, delta);
        QPointF newPos(shape->absolutePosition(KoFlake::Center) + delta);
        m_newPositions[i] = newPos;
 
        shape->setAbsolutePosition(newPos, KoFlake::Center);
        i++;
    }
 
    KoShapeBulkActionLock::bulkShapesUpdate(lock.unlock());
}

References KoShape::absolutePosition(), KoShapeBulkActionLock::bulkShapesUpdate(), KoToolBase::canvas(), KoFlake::Center, KoCanvasBase::clipToDocument(), m_newPositions, m_previousPositions, m_selectedShapes, KoShapeContainer::model, KoShape::parent(), KoShapeContainerModel::proposeMove(), KoShape::setAbsolutePosition(), KoInteractionStrategy::tool(), and KoShapeBulkActionLock::unlock().

paint()

void ShapeMoveStrategy::paint ( QPainter & painter, const KoViewConverter & converter )

overridevirtual

Reimplement this if the action needs to draw a "blob" on the canvas; that is, a transient decoration like a rubber band.

Reimplemented from KoInteractionStrategy.

Definition at line 108 of file ShapeMoveStrategy.cpp.

{
    Q_UNUSED(painter);
    Q_UNUSED(converter);
}

Member Data Documentation

m_canvas

QPointer<KoCanvasBase> ShapeMoveStrategy::m_canvas

private

Definition at line 49 of file ShapeMoveStrategy.h.

m_finalMove

QPointF ShapeMoveStrategy::m_finalMove

private

Definition at line 47 of file ShapeMoveStrategy.h.

m_initialOffset

QPointF ShapeMoveStrategy::m_initialOffset

private

Definition at line 47 of file ShapeMoveStrategy.h.

m_newPositions

QList<QPointF> ShapeMoveStrategy::m_newPositions

private

Definition at line 46 of file ShapeMoveStrategy.h.

m_previousPositions

QList<QPointF> ShapeMoveStrategy::m_previousPositions

private

Definition at line 45 of file ShapeMoveStrategy.h.

m_selectedShapes

QList<KoShape *> ShapeMoveStrategy::m_selectedShapes

private

Definition at line 48 of file ShapeMoveStrategy.h.

m_start

QPointF ShapeMoveStrategy::m_start

private

Definition at line 47 of file ShapeMoveStrategy.h.

---

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

• plugins/tools/defaulttool/defaulttool/ShapeMoveStrategy.h
• plugins/tools/defaulttool/defaulttool/ShapeMoveStrategy.cpp