Plot tool for temporarily zooming a plot while a key is depressed. More...

#include <qgsplottransienttools.h>

Inheritance diagram for QgsPlotToolTemporaryKeyZoom:

[legend]

Public Member Functions
	QgsPlotToolTemporaryKeyZoom (QgsPlotCanvas *canvas)
	Constructor for QgsPlotToolTemporaryKeyZoom.

void	activate () override
	Called when the tool is set as the currently active plot tool.

void	keyPressEvent (QKeyEvent *event) override
	Key press event for overriding.

void	keyReleaseEvent (QKeyEvent *event) override
	Key release event for overriding.

void	plotReleaseEvent (QgsPlotMouseEvent *event) override
	Mouse release event for overriding.

Public Member Functions inherited from QgsPlotToolZoom
	QgsPlotToolZoom (QgsPlotCanvas *canvas)
	Constructor for QgsPlotToolZoom, with the associated canvas.

	~QgsPlotToolZoom () override

void	deactivate () override
	Called when the tool is being deactivated.

void	keyPressEvent (QKeyEvent *event) override
	Key press event for overriding.

void	keyReleaseEvent (QKeyEvent *event) override
	Key release event for overriding.

void	plotMoveEvent (QgsPlotMouseEvent *event) override
	Mouse move event for overriding.

void	plotPressEvent (QgsPlotMouseEvent *event) override
	Mouse press event for overriding.

void	plotReleaseEvent (QgsPlotMouseEvent *event) override
	Mouse release event for overriding.

Public Member Functions inherited from QgsPlotTool
	~QgsPlotTool () override

QAction *	action ()
	Returns the action associated with the tool or `nullptr` if no action is associated.

QgsPlotCanvas *	canvas () const
	Returns the tool's plot canvas.

virtual bool	canvasToolTipEvent (QHelpEvent *event)
	Tooltip event for overriding.

virtual Qgis::PlotToolFlags	flags () const
	Returns the flags for the plot tool.

virtual bool	gestureEvent (QGestureEvent *event)
	Gesture event for overriding.

bool	isActive () const
	Returns `true` if this tool is the current tool active on the plot canvas.

virtual void	plotDoubleClickEvent (QgsPlotMouseEvent *event)
	Mouse double-click event for overriding.

virtual bool	populateContextMenuWithEvent (QMenu menu, QgsPlotMouseEvent event)
	Allows the tool to populate and customize the given menu, prior to showing it in response to a right-mouse button click.

void	setAction (QAction *action)
	Associates an action with this tool.

void	setCursor (const QCursor &cursor)
	Sets a user defined cursor for use when the tool is active.

QString	toolName () const
	Returns a user-visible, translated name for the tool.

virtual void	wheelEvent (QWheelEvent *event)
	Mouse wheel event for overriding.

Additional Inherited Members
Signals inherited from QgsPlotTool
void	activated ()
	Emitted when the tool is activated.

void	deactivated ()
	Emitted when the tool is deactivated.

Protected Member Functions inherited from QgsPlotToolZoom
virtual QRectF	constrainBounds (const QRectF &sceneBounds) const
	Applies constraints to the overall bounds of the rubber band.

virtual QPointF	constrainMovePoint (QPointF scenePoint) const
	Applies constraints to a move point of the zoom rubber band.

virtual QPointF	constrainStartPoint (QPointF scenePoint) const
	Applies constraints to the start point of the zoom rubber band.

virtual void	zoomInClickOn (QPointF scenePoint)
	Handles a zoom out click on the given point.

virtual void	zoomOutClickOn (QPointF scenePoint)
	Handles a zoom out click on the given point.

Protected Member Functions inherited from QgsPlotTool
	QgsPlotTool (QgsPlotCanvas *canvas, const QString &name)
	Constructor takes a plot canvas as a parameter.

bool	isClickAndDrag (QPoint startViewPoint, QPoint endViewPoint) const
	Returns `true` if a mouse press/release operation which started at startViewPoint and ended at endViewPoint should be considered a "click and drag".

QgsPointXY	toCanvasCoordinates (const QgsPoint &point) const
	Converts a point in map coordinates to the associated canvas point.

QgsPoint	toMapCoordinates (const QgsPointXY &point) const
	Converts a point on the canvas to the associated map coordinate.

Static Protected Member Functions inherited from QgsPlotTool
static QPointF	constrainPointToRect (QPointF point, const QRectF &rect)
	Constrains a point to force it to fall within the specified rectangle.

Protected Attributes inherited from QgsPlotToolZoom
bool	mMarqueeZoom = false
	Will be `true` will marquee zoom operation is in progress.

QPoint	mMousePressStartPos
	Start position for mouse drag.

QPointF	mRubberBandStartPos
	Start position for drag, in scene coordinates.

Protected Attributes inherited from QgsPlotTool
QPointer< QAction >	mAction
	Optional action associated with tool.

QgsPlotCanvas *	mCanvas = nullptr
	The pointer to the canvas.

QCursor	mCursor = Qt::ArrowCursor
	Cursor used by tool.

QString	mToolName
	Translated name of the map tool.

Detailed Description

Plot tool for temporarily zooming a plot while a key is depressed.

Since: QGIS 3.26

Definition at line 88 of file qgsplottransienttools.h.

Constructor & Destructor Documentation

◆ QgsPlotToolTemporaryKeyZoom()

QgsPlotToolTemporaryKeyZoom::QgsPlotToolTemporaryKeyZoom ( QgsPlotCanvas * canvas )

Constructor for QgsPlotToolTemporaryKeyZoom.

Definition at line 97 of file qgsplottransienttools.cpp.

Member Function Documentation

◆ activate()

void QgsPlotToolTemporaryKeyZoom::activate ( )

overridevirtual

Called when the tool is set as the currently active plot tool.

Reimplemented from QgsPlotTool.

Definition at line 174 of file qgsplottransienttools.cpp.

◆ keyPressEvent()

void QgsPlotToolTemporaryKeyZoom::keyPressEvent ( QKeyEvent * event )

overridevirtual

Key press event for overriding.

The default implementation does nothing. When subclasses implement this method and have acted on the event, they must explicitly call event->accept() to prevent the event from being passed on to other widgets.

Reimplemented from QgsPlotTool.

Definition at line 113 of file qgsplottransienttools.cpp.

◆ keyReleaseEvent()

void QgsPlotToolTemporaryKeyZoom::keyReleaseEvent ( QKeyEvent * event )

overridevirtual

Key release event for overriding.

The default implementation does nothing. When subclasses implement this method and have acted on the event, they must explicitly call event->accept() to prevent the event from being passed on to other widgets.

Reimplemented from QgsPlotTool.

Definition at line 146 of file qgsplottransienttools.cpp.

◆ plotReleaseEvent()

void QgsPlotToolTemporaryKeyZoom::plotReleaseEvent ( QgsPlotMouseEvent * event )

overridevirtual

Mouse release event for overriding.

The default implementation does nothing. When subclasses implement this method and have acted on the event, they must explicitly call event->accept() to prevent the event from being passed on to other widgets.

Reimplemented from QgsPlotTool.

Definition at line 102 of file qgsplottransienttools.cpp.

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

/build/qgis-3.41.0+git20241122+3440c17df1d+99sid/src/gui/plot/qgsplottransienttools.h
/build/qgis-3.41.0+git20241122+3440c17df1d+99sid/src/gui/plot/qgsplottransienttools.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ QgsPlotToolTemporaryKeyZoom()

Member Function Documentation

◆ activate()

◆ keyPressEvent()

◆ keyReleaseEvent()

◆ plotReleaseEvent()