KoToolBase Class Reference

#include <KoToolBase.h>

Inheritance diagram for KoToolBase:

Public Slots
virtual void	activate (const QSet< KoShape * > &shapes)
virtual void	canvasResourceChanged (int key, const QVariant &res)
virtual void	deactivate ()
virtual void	documentResourceChanged (int key, const QVariant &res)
virtual void	repaintDecorations ()
virtual void	requestRedoDuringStroke ()
virtual void	requestStrokeCancellation ()
virtual void	requestStrokeEnd ()
virtual void	requestUndoDuringStroke ()
void	setStatusText (const QString &statusText)
void	updateOptionsWidgetIcons ()

Signals
void	activateTool (const QString &id)
void	cursorChanged (const QCursor &cursor)
void	selectionChanged (bool hasSelection)
void	statusTextChanged (const QString &statusText)
void	textModeChanged (bool inTextMode)

Public Member Functions
QAction *	action (const QString &name) const
KoCanvasBase *	canvas () const
	Returns the canvas the tool is working on.
virtual void	copy () const
QCursor	cursor () const
	return the last emitted cursor
virtual void	customMoveEvent (KoPointerEvent *event)
virtual void	customPressEvent (KoPointerEvent *event)
virtual void	customReleaseEvent (KoPointerEvent *event)
virtual void	cut ()
virtual QRectF	decorationsRect () const
int	decorationThickness () const
	decorationThickness The minimum thickness for tool decoration lines, this is derived from the screen magnification, thus the HiDPI settings. Note: to use this effectively, also set the pen to isCosmetic(true);
virtual void	deleteSelection ()
virtual void	deselect ()
	deselect the tool should clear the selection if it has one.
virtual void	dragLeaveEvent (QDragLeaveEvent *event)
virtual void	dragMoveEvent (QDragMoveEvent *event, const QPointF &point)
virtual void	dropEvent (QDropEvent *event, const QPointF &point)
virtual void	explicitUserStrokeEndRequest ()
	explicitUserStrokeEndRequest is called by the input manager when the user presses Enter key or any equivalent. This callback comes before requestStrokeEnd(), which comes from a different source.
KoToolFactoryBase *	factory () const
virtual void	focusInEvent (QFocusEvent *event)
virtual void	focusOutEvent (QFocusEvent *event)
virtual bool	hasSelection ()
virtual void	inputMethodEvent (QInputMethodEvent *event)
virtual QVariant	inputMethodQuery (Qt::InputMethodQuery query) const
bool	isInTextMode () const
bool	isOpacityPresetMode () const
virtual void	keyPressEvent (QKeyEvent *event)
virtual void	keyReleaseEvent (QKeyEvent *event)
	KoToolBase (KoCanvasBase *canvas)
bool	maskSyntheticEvents () const
virtual void	mouseDoubleClickEvent (KoPointerEvent *event)
virtual void	mouseMoveEvent (KoPointerEvent *event)=0
virtual void	mousePressEvent (KoPointerEvent *event)=0
virtual void	mouseReleaseEvent (KoPointerEvent *event)=0
virtual void	mouseTripleClickEvent (KoPointerEvent *event)
QList< QPointer< QWidget > >	optionWidgets ()
virtual void	paint (QPainter &painter, const KoViewConverter &converter)=0
virtual bool	paste ()
virtual QMenu *	popupActionsMenu ()
virtual KisPopupWidgetInterface *	popupWidget ()
virtual bool	selectAll ()
	selectAll select all data the tool can select.
virtual KoToolSelection *	selection ()
Q_INVOKABLE QString	toolId () const
virtual bool	wantsAutoScroll () const
	~KoToolBase () override

Protected Member Functions
virtual QWidget *	createOptionWidget ()
virtual QList< QPointer< QWidget > >	createOptionWidgets ()
int	grabSensitivity () const
	Convenience function to get the current grab sensitivity.
qreal	handleDocRadius () const
QRectF	handleGrabRect (const QPointF &position) const
QRectF	handlePaintRect (const QPointF &position) const
int	handleRadius () const
	Convenience function to get the current handle radius.
bool	isActivated () const
	KoToolBase (KoToolBasePrivate &dd)
KoPointerEvent *	lastDeliveredPointerEvent () const
void	setAbstractResource (KoAbstractCanvasResourceInterfaceSP abstractResource)
void	setConverter (KoDerivedResourceConverterSP converter)
void	setIsOpacityPresetMode (bool value)
void	setMaskSyntheticEvents (bool value)
void	setTextMode (bool value)
QHash< int, KoAbstractCanvasResourceInterfaceSP >	toolAbstractResources ()
QHash< int, KoDerivedResourceConverterSP >	toolConverters ()
void	useCursor (const QCursor &cursor)

Protected Attributes
KoToolBasePrivate *	d_ptr

Private Member Functions
	KoToolBase ()
	KoToolBase (const KoToolBase &)
KoToolBase &	operator= (const KoToolBase &)
void	setFactory (KoToolFactoryBase *factory)

Friends
class	KoToolManager

Detailed Description

Abstract base class for all tools. Tools can create or manipulate flake shapes, canvas state or any other thing that a user may wish to do to his document or his view on a document with a pointing device.

There exists an instance of every tool for every pointer device. These instances are managed by the toolmanager..

Definition at line 56 of file KoToolBase.h.

Constructor & Destructor Documentation

KoToolBase() [1/4]

KoToolBase::KoToolBase ( KoCanvasBase * canvas )

explicit

Constructor, normally only called by the factory (see KoToolFactoryBase)

Parameters

canvas

the canvas interface this tool will work for.

Definition at line 42 of file KoToolBase.cpp.

    : d_ptr(new KoToolBasePrivate(this, canvas))
{
    Q_D(KoToolBase);
    d->connectSignals();
}

~KoToolBase()

KoToolBase::~KoToolBase ( )

override

Definition at line 56 of file KoToolBase.cpp.

{
    delete d_ptr;
}

References d_ptr.

KoToolBase() [2/4]

KoToolBase::KoToolBase ( KoToolBasePrivate & dd )

protected

Definition at line 49 of file KoToolBase.cpp.

    : d_ptr(&dd)
{
    Q_D(KoToolBase);
    d->connectSignals();
}

KoToolBase() [3/4]

KoToolBase::KoToolBase ( )

private

KoToolBase() [4/4]

KoToolBase::KoToolBase ( const KoToolBase & )

private

Member Function Documentation

action()

QAction * KoToolBase::action

(

const QString &

name

)

const

Retrieve an action by name.

Definition at line 204 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    if (d->canvas && d->canvas->canvasController() && d->canvas->canvasController()) {
        return d->canvas->canvasController()->actionCollection()->action(name);
    }
    return 0;
}

activate

void KoToolBase::activate ( const QSet< KoShape * > & shapes )

virtualslot

This method is called when this tool instance is activated. For any main window there is only one tool active at a time, which then gets all user input. Switching between tools will call deactivate on one and activate on the new tool allowing the tool to flush items (like a selection) when it is not in use.

Parameters

shapes

the set of shapes that are selected or suggested for editing by a selected shape for the tool to work on. Not all shapes will be meant for this tool.

See also

deactivate()

Reimplemented in KisToolColorSampler, KoPencilTool, KoPathTool, KoZoomTool, KisToolPolylineBase, KisToolRectangleBase, KisToolSelectBase< __KisToolSelectEllipticalLocal >, KisToolSelectBase< __KisToolSelectOutlineLocal >, KisToolSelectBase< __KisToolSelectPolygonalLocal >, KisToolSelectBase< __KisToolSelectRectangularLocal >, KisToolLine, KarbonCalligraphyTool, SvgTextTool, and KisToolDyna.

Definition at line 78 of file KoToolBase.cpp.

{
    Q_UNUSED(shapes);
 
    Q_D(KoToolBase);
    d->isActivated = true;
}

activateTool

void KoToolBase::activateTool ( const QString & id )

signal

Emitted when this tool wants itself to be replaced by another tool.

Parameters

id	the identification of the desired tool

See also

toolId(), KoToolFactoryBase::id()

canvas()

KoCanvasBase * KoToolBase::canvas

(

)

const

Returns the canvas the tool is working on.

Definition at line 264 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    return d->canvas;
}

canvasResourceChanged

void KoToolBase::canvasResourceChanged ( int key, const QVariant & res )

virtualslot

This method is called whenever a property in the resource provider associated with the canvas this tool belongs to changes. An example is currently selected foreground color.

Reimplemented in DefaultTool, KisToolCrop, and KisToolPaint.

Definition at line 92 of file KoToolBase.cpp.

{
    Q_UNUSED(key);
    Q_UNUSED(res);
}

copy()

void KoToolBase::copy ( ) const

virtual

copies the tools selection to the clipboard. The default implementation is empty to aid tools that don't have any selection.

See also

selection()

Reimplemented in DefaultTool, and SvgTextTool.

Definition at line 364 of file KoToolBase.cpp.

{
}

createOptionWidget()

QWidget * KoToolBase::createOptionWidget ( )

protectedvirtual

Reimplement this if your tool actually has an option widget. Sets the option widget to 0 by default.

Reimplemented in KoZoomTool, KisTool, KisToolPaint, KisToolSelectBase< __KisToolSelectEllipticalLocal >, KisToolSelectBase< __KisToolSelectOutlineLocal >, KisToolSelectBase< __KisToolSelectPolygonalLocal >, KisToolSelectBase< __KisToolSelectRectangularLocal >, KisToolShape, KisAssistantTool, KisToolBrush, KisToolColorSampler, KisToolFill, KisToolGradient, KisToolLine, KisToolMeasure, KisToolMove, KisToolMultihand, ToolReferenceImages, SvgTextTool, KisToolCrop, KisToolDyna, KisToolEncloseAndFill, KisDynamicDelegatedTool< KisToolShape >, KisToolKnife, KisToolLazyBrush, KisToolPolyline, KisToolSmartPatch, and KisToolTransform.

Definition at line 213 of file KoToolBase.cpp.

{
    return 0;
}

createOptionWidgets()

QList< QPointer< QWidget > > KoToolBase::createOptionWidgets ( )

protectedvirtual

Reimplemented in KoCreatePathTool, KoPencilTool, KoPathTool, KisToolRectangleBase, __KisToolPathLocalTool, __KisToolPencilLocalTool, DefaultTool, ToolReferenceImages, KarbonCalligraphyTool, __KisToolSelectPathLocalTool, and KisToolPathLocalTool.

Definition at line 218 of file KoToolBase.cpp.

{
    QList<QPointer<QWidget> > ow;
    if (QWidget *widget = createOptionWidget()) {
        if (widget->objectName().isEmpty()) {
            widget->setObjectName(toolId());
        }
        ow.append(widget);
    }
    return ow;
}

References createOptionWidget(), and toolId().

cursor()

QCursor KoToolBase::cursor

(

)

const

return the last emitted cursor

Definition at line 248 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    return d->currentCursor;
}

cursorChanged

void KoToolBase::cursorChanged ( const QCursor & cursor )

signal

Emitted by useCursor() when the cursor to display on the canvas is changed. The KoToolManager should connect to this signal to handle cursors further.

customMoveEvent()

void KoToolBase::customMoveEvent ( KoPointerEvent * event )

virtual

Called when a custom device moved over the canvas. Implementors should call event->ignore() if they do not actually use the event.

Parameters

event

state and reason of this custom device move

Definition at line 181 of file KoToolBase.cpp.

{
    event->ignore();
}

customPressEvent()

void KoToolBase::customPressEvent ( KoPointerEvent * event )

virtual

Called when (one of) a custom device buttons is pressed. Implementors should call event->ignore() if they do not actually use the event.

Parameters

event

state and reason of this custom device press

Definition at line 171 of file KoToolBase.cpp.

{
    event->ignore();
}

customReleaseEvent()

void KoToolBase::customReleaseEvent ( KoPointerEvent * event )

virtual

Called when (one of) a custom device buttons is released. Implementors should call event->ignore() if they do not actually use the event.

Parameters

event

state and reason of this custom device release

Definition at line 176 of file KoToolBase.cpp.

{
    event->ignore();
}

cut()

void KoToolBase::cut ( )

virtual

Cut the tools selection and copy it to the clipboard. The default implementation calls copy() and then deleteSelection()

See also

copy()

deleteSelection()

Definition at line 258 of file KoToolBase.cpp.

{
    copy();
    deleteSelection();
}

References copy(), and deleteSelection().

deactivate

void KoToolBase::deactivate ( )

virtualslot

This method is called whenever this tool is no longer the active tool

See also

activate()

Reimplemented in KoPencilTool, KoPathTool, KisToolPolylineBase, KisToolRectangleBase, KisToolSelectBase< __KisToolSelectEllipticalLocal >, KisToolSelectBase< __KisToolSelectOutlineLocal >, KisToolSelectBase< __KisToolSelectPolygonalLocal >, KisToolSelectBase< __KisToolSelectRectangularLocal >, KisToolColorSampler, KisToolLine, KarbonCalligraphyTool, and SvgTextTool.

Definition at line 86 of file KoToolBase.cpp.

{
    Q_D(KoToolBase);
    d->isActivated = false;
}

decorationsRect()

QRectF KoToolBase::decorationsRect ( ) const

virtual

Reimplemented in KoCreatePathTool, KoPathTool, DefaultTool, SvgTextTool, and KisDynamicDelegatedTool< KisToolShape >.

Definition at line 409 of file KoToolBase.cpp.

{
    return QRectF();
}

decorationThickness()

int KoToolBase::decorationThickness

(

)

const

decorationThickness The minimum thickness for tool decoration lines, this is derived from the screen magnification, thus the HiDPI settings. Note: to use this effectively, also set the pen to isCosmetic(true);

Returns

the minimum thickness for decoration lines in pixels.

Definition at line 297 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    if (d->canvas
            && d->canvas->resourceManager()
       )
    {
        return d->canvas->resourceManager()->decorationThickness();
    }
    else {
        return 1;
    }
}

deleteSelection()

void KoToolBase::deleteSelection ( )

virtual

Delete the tools selection. The default implementation is empty to aid tools that don't have any selection.

See also

selection()

Reimplemented in KoPathTool, KisTool, DefaultTool, ToolReferenceImages, and SvgTextTool.

Definition at line 254 of file KoToolBase.cpp.

{
}

deselect()

void KoToolBase::deselect ( )

virtual

deselect the tool should clear the selection if it has one.

Reimplemented in KoPathTool, DefaultTool, and SvgTextTool.

Definition at line 360 of file KoToolBase.cpp.

{
}

documentResourceChanged

void KoToolBase::documentResourceChanged ( int key, const QVariant & res )

virtualslot

This method is called whenever a property in the resource provider associated with the document this tool belongs to changes. An example is the handle radius

Definition at line 98 of file KoToolBase.cpp.

{
    Q_UNUSED(key);
    Q_UNUSED(res);
}

dragLeaveEvent()

void KoToolBase::dragLeaveEvent ( QDragLeaveEvent * event )

virtual

Handle the dragLeaveEvent Basically just a notification that the drag is no long relevant The tool should Accept the event if it is meaningful; Default implementation does not.

Definition at line 374 of file KoToolBase.cpp.

{
    Q_UNUSED(event);
}

dragMoveEvent()

void KoToolBase::dragMoveEvent ( QDragMoveEvent * event, const QPointF & point )

virtual

Handle the dragMoveEvent A tool typically has one or more shapes selected and dropping into should do something meaningful for this specific shape and tool combination. For example dropping text in a text tool. The tool should Accept the event if it is meaningful; Default implementation does not.

Definition at line 368 of file KoToolBase.cpp.

{
    Q_UNUSED(event);
    Q_UNUSED(point);
}

dropEvent()

void KoToolBase::dropEvent ( QDropEvent * event, const QPointF & point )

virtual

Handle the dropEvent A tool typically has one or more shapes selected and dropping into should do something meaningful for this specific shape and tool combination. For example dropping text in a text tool. The tool should Accept the event if it is meaningful; Default implementation does not.

Definition at line 379 of file KoToolBase.cpp.

{
    Q_UNUSED(event);
    Q_UNUSED(point);
}

explicitUserStrokeEndRequest()

void KoToolBase::explicitUserStrokeEndRequest ( )

virtual

explicitUserStrokeEndRequest is called by the input manager when the user presses Enter key or any equivalent. This callback comes before requestStrokeEnd(), which comes from a different source.

Reimplemented in KoPathTool, DefaultTool, KisDynamicDelegatedTool< KisToolShape >, and KisToolLazyBrush.

Definition at line 130 of file KoToolBase.cpp.

{
}

factory()

KoToolFactoryBase * KoToolBase::factory

(

)

const

The factory holds properties common to all instances of the same tool type, such as the string identifying the class or the icon name.

Not all tool instances have a factory reference, for example the "delegated" inner implementations to which events are forwarded don't have one, as well as instances created by regression tests.

Every instance used by the tool manager has a factory reference and a tool identifier, but they're not available during construction.

Definition at line 236 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    return d->factory;
}

focusInEvent()

void KoToolBase::focusInEvent ( QFocusEvent * event )

virtual

This passes on the focusInEven from the canvas widget, which can be used to activate animating decorations (like a cursor blink effect in the text tool).

Reimplemented in SvgTextTool.

Definition at line 161 of file KoToolBase.cpp.

{
    event->ignore();
}

focusOutEvent()

void KoToolBase::focusOutEvent ( QFocusEvent * event )

virtual

This passes on the focusInEven from the canvas widget, which can be used to deactivate animating decorations (like a cursor blink effect in the text tool).

Reimplemented in SvgTextTool.

Definition at line 166 of file KoToolBase.cpp.

{
    event->ignore();
}

grabSensitivity()

int KoToolBase::grabSensitivity ( ) const

protected

Convenience function to get the current grab sensitivity.

Definition at line 311 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    if(d->canvas->shapeController()->resourceManager())
    {
        return d->canvas->shapeController()->resourceManager()->grabSensitivity();
    } else {
        return 3;
    }
}

handleDocRadius()

qreal KoToolBase::handleDocRadius ( ) const

protected

Convenience function to get the current handle radius measured in document coordinates (points)

Definition at line 289 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    const KoViewConverter * converter = d->canvas->viewConverter();
    const QPointF doc = converter->viewToDocument(QPointF(handleRadius(), handleRadius()));
    return qMax(doc.x(), doc.y());
}

References handleRadius(), and KoViewConverter::viewToDocument().

handleGrabRect()

QRectF KoToolBase::handleGrabRect ( const QPointF & position ) const

protected

Returns a handle grab rect at the given position.

The position is expected to be in document coordinates. The grab sensitivity canvas resource is used for the dimension of the rectangle.

Returns

the handle rectangle in document coordinates

Definition at line 322 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    const KoViewConverter * converter = d->canvas->viewConverter();
    uint handleSize = 2*grabSensitivity();
    QRectF r = converter->viewToDocument(QRectF(0, 0, handleSize, handleSize));
    r.moveCenter(position);
    return r;
}

References grabSensitivity(), and KoViewConverter::viewToDocument().

handlePaintRect()

QRectF KoToolBase::handlePaintRect ( const QPointF & position ) const

protected

Returns a handle paint rect at the given position.

The position is expected to be in document coordinates. The handle radius canvas resource is used for the dimension of the rectangle.

Returns

the handle rectangle in document coordinates

Definition at line 332 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    const KoViewConverter * converter = d->canvas->viewConverter();
    uint handleSize = 2*handleRadius();
    QRectF r = converter->viewToDocument(QRectF(0, 0, handleSize, handleSize));
    r.moveCenter(position);
    return r;
}

References handleRadius(), and KoViewConverter::viewToDocument().

handleRadius()

int KoToolBase::handleRadius ( ) const

protected

Convenience function to get the current handle radius.

Definition at line 275 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    if (d->canvas
            && d->canvas->resourceManager()
       )
    {
        return d->canvas->resourceManager()->handleRadius();
    }
    else {
        return 3;
    }
}

hasSelection()

bool KoToolBase::hasSelection ( )

virtual

Returns

true if the tool has selected data.

Reimplemented in ToolReferenceImages, and SvgTextTool.

Definition at line 385 of file KoToolBase.cpp.

{
    KoToolSelection *sel = selection();
    return (sel && sel->hasSelection());
}

References KoToolSelection::hasSelection(), and selection().

inputMethodEvent()

void KoToolBase::inputMethodEvent ( QInputMethodEvent * event )

virtual

Text entry of complex text, like CJK, can be made more interactive if a tool implements this and the InputMethodQuery() methods. Reimplementing this only provides the user with a more responsive text experience, since the default implementation forwards the typed text as key pressed events.

Parameters

event

the input method event.

Reimplemented in SvgTextTool.

Definition at line 152 of file KoToolBase.cpp.

{
    if (! event->commitString().isEmpty()) {
        QKeyEvent ke(QEvent::KeyPress, -1, QFlags<Qt::KeyboardModifier>(), event->commitString());
        keyPressEvent(&ke);
    }
    event->accept();
}

References keyPressEvent().

inputMethodQuery()

QVariant KoToolBase::inputMethodQuery ( Qt::InputMethodQuery query ) const

virtual

This method is used to query a set of properties of the tool to be able to support complex input method operations as support for surrounding text and reconversions. Default implementation returns simple defaults, for tools that want to provide a more responsive text entry experience for CJK languages it would be good to reimplement.

Parameters

query	specifies which property is queried.
converter	the view converter for the current canvas.

Reimplemented in SvgTextTool.

Definition at line 134 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    if (d->canvas->canvasWidget() == 0)
        return QVariant();
 
    switch (query) {
    case Qt::ImEnabled:
        return isInTextMode();
    case Qt::ImCursorRectangle:
        return QRect(d->canvas->canvasWidget()->width() / 2, 0, 1, d->canvas->canvasWidget()->height());
    case Qt::ImFont:
        return d->canvas->canvasWidget()->font();
    default:
        return QVariant();
    }
}

References isInTextMode().

isActivated()

bool KoToolBase::isActivated ( ) const

protected

Returns true if activate() has been called (more times than deactivate :) )

Definition at line 62 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    return d->isActivated;
}

isInTextMode()

bool KoToolBase::isInTextMode

(

)

const

This method can be reimplemented in a subclass.

Returns

returns true, if the tool is in text mode. that means, that there is any kind of textual input and all single key shortcuts should be eaten.

Definition at line 414 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    return d->isInTextMode;
}

isOpacityPresetMode()

bool KoToolBase::isOpacityPresetMode

(

)

const

Returns

true if the tool uses preset opacity, false if it uses tool.

Definition at line 453 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    return d->isOpacityPresetMode;
}

keyPressEvent()

void KoToolBase::keyPressEvent ( QKeyEvent * event )

virtual

Called when a key is pressed. Implementors should call event->ignore() if they do not actually use the event. Default implementation ignores this event.

Parameters

event

state and reason of this key press

Reimplemented in KoPencilTool, KoInteractionTool, KoPathTool, KoZoomTool, KisToolRectangleBase, KisToolSelectBase< __KisToolSelectEllipticalLocal >, KisToolSelectBase< __KisToolSelectOutlineLocal >, KisToolSelectBase< __KisToolSelectPolygonalLocal >, KisToolSelectBase< __KisToolSelectRectangularLocal >, KisToolOutlineBase, KisAssistantTool, KisToolPan, DefaultTool, SvgTextTool, and KisDynamicDelegatedTool< KisToolShape >.

Definition at line 119 of file KoToolBase.cpp.

{
    e->ignore();
}

keyReleaseEvent()

void KoToolBase::keyReleaseEvent ( QKeyEvent * event )

virtual

Called when a key is released Implementors should call event->ignore() if they do not actually use the event. Default implementation ignores this event.

Parameters

event

state and reason of this key release

Reimplemented in KoInteractionTool, KoPathTool, KoZoomTool, KisToolRectangleBase, KisToolSelectBase< __KisToolSelectEllipticalLocal >, KisToolSelectBase< __KisToolSelectOutlineLocal >, KisToolSelectBase< __KisToolSelectPolygonalLocal >, KisToolSelectBase< __KisToolSelectRectangularLocal >, KisToolOutlineBase, SvgTextTool, and KisDynamicDelegatedTool< KisToolShape >.

Definition at line 124 of file KoToolBase.cpp.

{
    e->ignore();
}

lastDeliveredPointerEvent()

KoPointerEvent * KoToolBase::lastDeliveredPointerEvent ( ) const

protected

Returns the last pointer event that was delivered to the canvas, the tool belongs to. This event might be used as an approximation for the event0 handlers not having their own events, like activate()/deactivate().

Definition at line 68 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
 
    if (!d->canvas) return 0;
    if (!d->canvas->toolProxy()) return 0;
 
    return d->canvas->toolProxy()->lastDeliveredPointerEvent();
}

maskSyntheticEvents()

bool KoToolBase::maskSyntheticEvents

(

)

const

Returns

true if synthetic mouse events on the canvas should be eaten.

For example, the guides tool should allow click and drag with touch, while the same touch events should be rejected by the freehand tool.

These events are sent by the OS in Windows

Definition at line 441 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    return d->maskSyntheticEvents;
}

mouseDoubleClickEvent()

void KoToolBase::mouseDoubleClickEvent ( KoPointerEvent * event )

virtual

Called when (one of) the mouse or stylus buttons is double clicked. Implementors should call event->ignore() if they do not actually use the event. Default implementation ignores this event.

Parameters

event

state and reason of this mouse or stylus press

Reimplemented in ToolReferenceImages, KoCreatePathTool, KoPathTool, KoZoomTool, KisTool, DefaultTool, SvgTextTool, and KisDynamicDelegatedTool< KisToolShape >.

Definition at line 109 of file KoToolBase.cpp.

{
    event->ignore();
}

mouseMoveEvent()

virtual void KoToolBase::mouseMoveEvent ( KoPointerEvent * event )

pure virtual

Called when the mouse or stylus moved over the canvas. Implementors should call event->ignore() if they do not actually use the event.

Parameters

event

state and reason of this mouse or stylus move

Implemented in KisToolCrop, KisToolTransform, KoCreatePathTool, KoPencilTool, KoInteractionTool, KoPathTool, KoZoomTool, KisTool, KisToolFreehand, KisToolPaint, KisToolPolylineBase, KisToolSelectBase< __KisToolSelectEllipticalLocal >, KisToolSelectBase< __KisToolSelectOutlineLocal >, KisToolSelectBase< __KisToolSelectPolygonalLocal >, KisToolSelectBase< __KisToolSelectRectangularLocal >, KisToolOutlineBase, KisAssistantTool, KisToolColorSampler, KisToolMove, KisToolMultihand, DefaultTool, KarbonCalligraphyTool, SvgTextTool, KisDynamicDelegatedTool< KisToolShape >, and KisToolBasicBrushBase.

mousePressEvent()

virtual void KoToolBase::mousePressEvent ( KoPointerEvent * event )

pure virtual

Called when (one of) the mouse or stylus buttons is pressed. Implementors should call event->ignore() if they do not actually use the event.

Parameters

event

state and reason of this mouse or stylus press

Implemented in KisToolTransform, KoCreatePathTool, KoPencilTool, KoInteractionTool, KoPathTool, KisTool, KisToolPaint, DefaultTool, KarbonCalligraphyTool, SvgTextTool, and KisDynamicDelegatedTool< KisToolShape >.

mouseReleaseEvent()

virtual void KoToolBase::mouseReleaseEvent ( KoPointerEvent * event )

pure virtual

Called when (one of) the mouse or stylus buttons is released. Implementors should call event->ignore() if they do not actually use the event.

Parameters

event

state and reason of this mouse or stylus release

Implemented in KisToolTransform, KoCreatePathTool, KoPencilTool, KoInteractionTool, KoPathTool, KoZoomTool, KisTool, KisToolPaint, DefaultTool, KarbonCalligraphyTool, SvgTextTool, and KisDynamicDelegatedTool< KisToolShape >.

mouseTripleClickEvent()

void KoToolBase::mouseTripleClickEvent ( KoPointerEvent * event )

virtual

Called when (one of) the mouse or stylus buttons is triple clicked. Implementors should call event->ignore() if they do not actually use the event. Default implementation ignores this event.

Parameters

event

state and reason of this mouse or stylus press

Reimplemented in KisTool, SvgTextTool, and KisDynamicDelegatedTool< KisToolShape >.

Definition at line 114 of file KoToolBase.cpp.

{
    event->ignore();
}

operator=()

KoToolBase & KoToolBase::operator= ( const KoToolBase & )

private

optionWidgets()

QList< QPointer< QWidget > > KoToolBase::optionWidgets

(

)

Return the option widgets for this tool. Create them if they do not exist yet. If the tool does not have an option widget, this method return an empty list. (After discussion with Thomas, who prefers the toolmanager to handle that case.)

See also

m_optionWidgets

Definition at line 193 of file KoToolBase.cpp.

{
    Q_D(KoToolBase);
    if (!d->optionWidgetsCreated) {
        KisScopedPerformanceLogger perfLog(QStringLiteral("KoToolBase::optionWidgets(%1)").arg(toolId()));
        d->optionWidgets = createOptionWidgets();
        d->optionWidgetsCreated = true;
    }
    return d->optionWidgets;
}

References createOptionWidgets(), and toolId().

paint()

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

pure virtual

Called by the canvas to paint any decorations that the tool deems needed. The painter has the top left of the canvas as its origin.

Parameters

painter	used for painting the shape
converter	to convert between internal and view coordinates.

Implemented in KisToolPaint, KisToolPolylineBase, KisToolRectangleBase, KisToolOutlineBase, KisAssistantTool, KisToolColorSampler, KisToolLine, KisToolMeasure, KisToolMove, KisToolMultihand, SvgTextTool, KisToolBasicBrushBase, KisToolTransform, KoCreatePathTool, KoPencilTool, KoInteractionTool, KoPathTool, KisToolGradient, KisToolPan, __KisToolPencilLocalTool, DefaultTool, KarbonCalligraphyTool, KisToolCrop, KisDynamicDelegatedTool< KisToolShape >, KisToolKnife, and KisToolSmartPatch.

paste()

bool KoToolBase::paste ( )

virtual

Paste the clipboard selection. A tool typically has one or more shapes selected and pasting should do something meaningful for this specific shape and tool combination. Inserting text in a text tool, for example.

Returns

will return true if pasting succeeded. False if nothing happened.

Reimplemented in DefaultTool, and SvgTextTool.

Definition at line 350 of file KoToolBase.cpp.

{
    return false;
}

popupActionsMenu()

virtual QMenu * KoToolBase::popupActionsMenu ( )

inlinevirtual

Returns

a menu with context-aware actions for the current selection. If the returned value is null, no context menu is shown.

Reimplemented in KoPathTool, KisToolSelectBase< __KisToolSelectEllipticalLocal >, KisToolSelectBase< __KisToolSelectOutlineLocal >, KisToolSelectBase< __KisToolSelectPolygonalLocal >, KisToolSelectBase< __KisToolSelectRectangularLocal >, DefaultTool, ToolReferenceImages, KisToolCrop, KisDynamicDelegatedTool< KisToolShape >, and KisToolTransform.

Definition at line 334 of file KoToolBase.h.

{return nullptr;}

popupWidget()

virtual KisPopupWidgetInterface * KoToolBase::popupWidget ( )

inlinevirtual

Returns

a widget with useful controls to be popped up on top of the canvas. Will not be called if popupActionsMenu() does not return null.

Reimplemented in KisToolPaint, KisToolPolylineBase, KisToolSelectBase< __KisToolSelectEllipticalLocal >, KisToolSelectBase< __KisToolSelectOutlineLocal >, KisToolSelectBase< __KisToolSelectPolygonalLocal >, KisToolSelectBase< __KisToolSelectRectangularLocal >, KisToolOutlineBase, KarbonCalligraphyTool, SvgTextTool, and KisDynamicDelegatedTool< KisToolShape >.

Definition at line 340 of file KoToolBase.h.

{return nullptr;}

repaintDecorations

void KoToolBase::repaintDecorations ( )

virtualslot

request a repaint of the decorations to be made. This triggers an update call on the canvas, but does not paint directly.

Reimplemented in KoPathTool.

Definition at line 396 of file KoToolBase.cpp.

{
    Q_D(KoToolBase);
 
    QRectF dirtyRect = d->lastDecorationsRect;
    d->lastDecorationsRect = decorationsRect();
    dirtyRect |= d->lastDecorationsRect;
 
    if (!dirtyRect.isEmpty()) {
        canvas()->updateCanvas(dirtyRect);
    }
}

References canvas(), decorationsRect(), and KoCanvasBase::updateCanvas().

requestRedoDuringStroke

void KoToolBase::requestRedoDuringStroke ( )

virtualslot

Called when the user requested redo while the stroke is active. If your tool supports redo and maintains an intermediate state which can interfere with redo override this method to handle the state.

Definition at line 429 of file KoToolBase.cpp.

{
}

requestStrokeCancellation

void KoToolBase::requestStrokeCancellation ( )

virtualslot

Called when the user requested the cancellation of the current stroke. If you tool supports cancelling, override this method and do the needed work there

Reimplemented in KoPathTool, KisToolPolylineBase, KisToolLine, and SvgTextTool.

Definition at line 433 of file KoToolBase.cpp.

{
}

requestStrokeEnd

void KoToolBase::requestStrokeEnd ( )

virtualslot

Called when the image decided that the stroke should better be ended. If you tool supports long strokes, override this method and do the needed work there

Reimplemented in KoPathTool, KisToolPolylineBase, KisToolLine, and SvgTextTool.

Definition at line 437 of file KoToolBase.cpp.

{
}

requestUndoDuringStroke

void KoToolBase::requestUndoDuringStroke ( )

virtualslot

Called when the user requested undo while the stroke is active. If you tool supports undo of the part of its actions, override this method and do the needed work there.

NOTE: Default implementation forwards this request to requestStrokeCancellation() method, so that the stroke would be cancelled.

Default implementation just cancels the stroke

Reimplemented in KoPathTool.

Definition at line 420 of file KoToolBase.cpp.

{
    requestStrokeCancellation();
}

References requestStrokeCancellation().

selectAll()

bool KoToolBase::selectAll ( )

virtual

selectAll select all data the tool can select.

Returns

true if something happened, false if nothing happened.

Reimplemented in KoPathTool, DefaultTool, and SvgTextTool.

Definition at line 355 of file KoToolBase.cpp.

{
    return false;
}

selection()

KoToolSelection * KoToolBase::selection ( )

virtual

Returns the internal selection object of this tool. Each tool can have a selection which is private to that tool and the specified shape that it comes with. The default returns 0.

Reimplemented in KoPathTool, DefaultTool, and SvgTextTool.

Definition at line 391 of file KoToolBase.cpp.

{
    return 0;
}

selectionChanged

void KoToolBase::selectionChanged ( bool hasSelection )

signal

A tool can have a selection that is copy-able, this signal is emitted when that status changes.

Parameters

hasSelection

is true when the tool holds selected data.

setAbstractResource()

void KoToolBase::setAbstractResource ( KoAbstractCanvasResourceInterfaceSP abstractResource )

protected

Definition at line 470 of file KoToolBase.cpp.

                                                                                         {
    Q_D(KoToolBase);
    d->toolCanvasResources.abstractResources[abstractResource->key()] = abstractResource;
}

setConverter()

void KoToolBase::setConverter ( KoDerivedResourceConverterSP converter )

protected

Definition at line 465 of file KoToolBase.cpp.

                                                                    {
    Q_D(KoToolBase);
    d->toolCanvasResources.converters[converter->key()] = converter;
}

setFactory()

void KoToolBase::setFactory ( KoToolFactoryBase * factory )

private

Set the KoToolFactoryBase that created this tool.

Parameters

factory

the KoToolFactoryBase

See also

KoToolFactoryBase

Definition at line 230 of file KoToolBase.cpp.

{
    Q_D(KoToolBase);
    d->factory = factory;
}

References factory().

setIsOpacityPresetMode()

void KoToolBase::setIsOpacityPresetMode ( bool value )

protected

Sets the opacity mode to either preset (true) or tool (false).

Definition at line 459 of file KoToolBase.cpp.

{
    Q_D(KoToolBase);
    d->isOpacityPresetMode = value;
}

References value().

setMaskSyntheticEvents()

void KoToolBase::setMaskSyntheticEvents ( bool value )

protected

Allows subclasses to specify whether synthetic mouse events should be accepted.

Definition at line 447 of file KoToolBase.cpp.

{
    Q_D(KoToolBase);
    d->maskSyntheticEvents = value;
}

References value().

setStatusText

void KoToolBase::setStatusText ( const QString & statusText )

slot

This method just relays the given text via the tools statusTextChanged signal.

Parameters

statusText

the new status text

Definition at line 270 of file KoToolBase.cpp.

{
    Q_EMIT statusTextChanged(statusText);
}

References statusTextChanged().

setTextMode()

void KoToolBase::setTextMode ( bool value )

protected

You should set the text mode to true in subclasses, if this tool is in text input mode, eg if the users are able to type. If you don't set it, then single key shortcuts will get the key event and not this tool.

Definition at line 342 of file KoToolBase.cpp.

{
    Q_D(KoToolBase);
    d->isInTextMode = value;
    qApp->inputMethod()->update(Qt::ImEnabled);
    Q_EMIT textModeChanged(d->isInTextMode);
}

References textModeChanged(), and value().

statusTextChanged

void KoToolBase::statusTextChanged ( const QString & statusText )

signal

Emitted when the tool wants to display a different status text

Parameters

statusText

the new status text

textModeChanged

void KoToolBase::textModeChanged ( bool inTextMode )

signal

Emitted when the tool's text mode has changed.

Parameters

inTextMode

whether it is now in text mode.

toolAbstractResources()

QHash< int, KoAbstractCanvasResourceInterfaceSP > KoToolBase::toolAbstractResources ( )

protected

Definition at line 475 of file KoToolBase.cpp.

{
    Q_D(KoToolBase);
    return d->toolCanvasResources.abstractResources;
}

toolConverters()

QHash< int, KoDerivedResourceConverterSP > KoToolBase::toolConverters ( )

protected

Definition at line 481 of file KoToolBase.cpp.

{
    Q_D(KoToolBase);
    return d->toolCanvasResources.converters;
}

toolId()

QString KoToolBase::toolId

(

)

const

get the identifier code from the KoToolFactoryBase that created this tool.

Returns

the toolId.

See also

KoToolFactoryBase::id()

Definition at line 242 of file KoToolBase.cpp.

{
    Q_D(const KoToolBase);
    return d->factory ? d->factory->id() : 0;
}

updateOptionsWidgetIcons

void KoToolBase::updateOptionsWidgetIcons ( )

slot

force the update of the icons on the cached options widget

Definition at line 487 of file KoToolBase.cpp.

{
    Q_D(KoToolBase);
    if (d->optionWidgetsCreated) {
        QObjectList objects;
        Q_FOREACH (QPointer<QWidget> widget, d->optionWidgets) {
            objects.append(widget);
        }
        while (!objects.isEmpty()) {
            QObject* object = objects.takeFirst();
            objects.append(object->children());
            KisIconUtils::updateIconCommon(object);
        }
    }
}

References KisIconUtils::updateIconCommon().

useCursor()

void KoToolBase::useCursor ( const QCursor & cursor )

protected

Classes inheriting from this one can call this method to signify which cursor the tool wants to display at this time. Logical place to call it is after an incoming event has been handled.

Parameters

cursor

the new cursor.

Definition at line 186 of file KoToolBase.cpp.

{
    Q_D(KoToolBase);
    d->currentCursor = cursor;
    Q_EMIT cursorChanged(d->currentCursor);
}

References cursor(), and cursorChanged().

wantsAutoScroll()

bool KoToolBase::wantsAutoScroll ( ) const

virtual

Return if dragging (moving with the mouse down) to the edge of a canvas should scroll the canvas (default is true).

Returns

if this tool wants mouse events to cause scrolling of canvas.

Reimplemented in KisToolFreehand, KisToolFill, KisToolMove, KisToolPan, DefaultTool, KisToolEncloseAndFill, KisDynamicDelegatedTool< KisToolShape >, and KisToolTransform.

Definition at line 104 of file KoToolBase.cpp.

{
    return true;
}

Friends And Related Symbol Documentation

KoToolManager

friend class KoToolManager

friend

Definition at line 572 of file KoToolBase.h.

Member Data Documentation

d_ptr

KoToolBasePrivate* KoToolBase::d_ptr

protected

Definition at line 567 of file KoToolBase.h.

---

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

• libs/flake/KoToolBase.h
• libs/flake/KoToolBase.cpp