diff --git a/python/PyQt6/gui/auto_generated/qgsmaptooladvanceddigitizing.sip.in b/python/PyQt6/gui/auto_generated/qgsmaptooladvanceddigitizing.sip.in index d1725e465ba5c..2d87a37adbd96 100644 --- a/python/PyQt6/gui/auto_generated/qgsmaptooladvanceddigitizing.sip.in +++ b/python/PyQt6/gui/auto_generated/qgsmaptooladvanceddigitizing.sip.in @@ -39,6 +39,7 @@ Creates an advanced digitizing maptool :param canvas: The map canvas on which the tool works :param cadDockWidget: The cad dock widget which will be used to adjust mouse events %End + ~QgsMapToolAdvancedDigitizing(); virtual void canvasPressEvent( QgsMapMouseEvent *e ); @@ -90,6 +91,9 @@ may keep advanced digitizing allowed all the time. If ``True`` is returned, that does not mean that advanced digitizing is actually active, because it is up to the user to enable/disable it when it is allowed. + +The default is that advanced digitizing is allowed. + \sa :py:func:`~QgsMapToolAdvancedDigitizing.setAdvancedDigitizingAllowed` %End @@ -99,7 +103,21 @@ Returns whether mouse events (press/move/release) should automatically try to sn (according to the snapping configuration of map canvas) before passing the mouse coordinates to the tool. This may be desirable default behavior for some map tools, but not for other map tools. It is therefore possible to configure the behavior by the map tool. + +The default is that auto snapping is enabled. + \sa :py:func:`~QgsMapToolAdvancedDigitizing.isAutoSnapEnabled` +%End + + bool useSnappingIndicator() const; +%Docstring +Returns whether the snapping indicator should automatically be used. + +The default is that a snap indicator is not used. + +.. seealso:: :py:func:`setUseSnappingIndicator` + +.. versionadded:: 3.40 %End protected: @@ -108,6 +126,9 @@ It is therefore possible to configure the behavior by the map tool. %Docstring Sets whether functionality of advanced digitizing dock widget is currently allowed. This method is protected because it should be a decision of the map tool and not from elsewhere. + +The default is that advanced digitizing is allowed. + \sa :py:func:`~QgsMapToolAdvancedDigitizing.isAdvancedDigitizingAllowed` %End @@ -115,9 +136,23 @@ This method is protected because it should be a decision of the map tool and not %Docstring Sets whether mouse events (press/move/release) should automatically try to snap mouse position This method is protected because it should be a decision of the map tool and not from elsewhere. + +The default is that auto snapping is enabled. + \sa :py:func:`~QgsMapToolAdvancedDigitizing.isAutoSnapEnabled` %End + void setUseSnappingIndicator( bool enabled ); +%Docstring +Sets whether a snapping indicator should automatically be used. + +The default is that a snap indicator is not used. + +.. seealso:: :py:func:`useSnappingIndicator` + +.. versionadded:: 3.40 +%End + public: diff --git a/python/gui/auto_generated/qgsmaptooladvanceddigitizing.sip.in b/python/gui/auto_generated/qgsmaptooladvanceddigitizing.sip.in index d1725e465ba5c..2d87a37adbd96 100644 --- a/python/gui/auto_generated/qgsmaptooladvanceddigitizing.sip.in +++ b/python/gui/auto_generated/qgsmaptooladvanceddigitizing.sip.in @@ -39,6 +39,7 @@ Creates an advanced digitizing maptool :param canvas: The map canvas on which the tool works :param cadDockWidget: The cad dock widget which will be used to adjust mouse events %End + ~QgsMapToolAdvancedDigitizing(); virtual void canvasPressEvent( QgsMapMouseEvent *e ); @@ -90,6 +91,9 @@ may keep advanced digitizing allowed all the time. If ``True`` is returned, that does not mean that advanced digitizing is actually active, because it is up to the user to enable/disable it when it is allowed. + +The default is that advanced digitizing is allowed. + \sa :py:func:`~QgsMapToolAdvancedDigitizing.setAdvancedDigitizingAllowed` %End @@ -99,7 +103,21 @@ Returns whether mouse events (press/move/release) should automatically try to sn (according to the snapping configuration of map canvas) before passing the mouse coordinates to the tool. This may be desirable default behavior for some map tools, but not for other map tools. It is therefore possible to configure the behavior by the map tool. + +The default is that auto snapping is enabled. + \sa :py:func:`~QgsMapToolAdvancedDigitizing.isAutoSnapEnabled` +%End + + bool useSnappingIndicator() const; +%Docstring +Returns whether the snapping indicator should automatically be used. + +The default is that a snap indicator is not used. + +.. seealso:: :py:func:`setUseSnappingIndicator` + +.. versionadded:: 3.40 %End protected: @@ -108,6 +126,9 @@ It is therefore possible to configure the behavior by the map tool. %Docstring Sets whether functionality of advanced digitizing dock widget is currently allowed. This method is protected because it should be a decision of the map tool and not from elsewhere. + +The default is that advanced digitizing is allowed. + \sa :py:func:`~QgsMapToolAdvancedDigitizing.isAdvancedDigitizingAllowed` %End @@ -115,9 +136,23 @@ This method is protected because it should be a decision of the map tool and not %Docstring Sets whether mouse events (press/move/release) should automatically try to snap mouse position This method is protected because it should be a decision of the map tool and not from elsewhere. + +The default is that auto snapping is enabled. + \sa :py:func:`~QgsMapToolAdvancedDigitizing.isAutoSnapEnabled` %End + void setUseSnappingIndicator( bool enabled ); +%Docstring +Sets whether a snapping indicator should automatically be used. + +The default is that a snap indicator is not used. + +.. seealso:: :py:func:`useSnappingIndicator` + +.. versionadded:: 3.40 +%End + public: diff --git a/src/gui/qgsmaptooladvanceddigitizing.cpp b/src/gui/qgsmaptooladvanceddigitizing.cpp index 85fad034aa957..ae2f19dce5e2e 100644 --- a/src/gui/qgsmaptooladvanceddigitizing.cpp +++ b/src/gui/qgsmaptooladvanceddigitizing.cpp @@ -29,6 +29,8 @@ QgsMapToolAdvancedDigitizing::QgsMapToolAdvancedDigitizing( QgsMapCanvas *canvas connect( canvas, &QgsMapCanvas::currentLayerChanged, this, &QgsMapToolAdvancedDigitizing::onCurrentLayerChanged ); } +QgsMapToolAdvancedDigitizing::~QgsMapToolAdvancedDigitizing() = default; + void QgsMapToolAdvancedDigitizing::canvasPressEvent( QgsMapMouseEvent *e ) { if ( isAdvancedDigitizingAllowed() && mCadDockWidget->cadEnabled() ) @@ -115,6 +117,11 @@ void QgsMapToolAdvancedDigitizing::canvasMoveEvent( QgsMapMouseEvent *e ) mSnapToGridCanvasItem->setPoint( e->mapPoint() ); } + if ( mSnapIndicator ) + { + mSnapIndicator->setMatch( e->mapPointMatch() ); + } + cadCanvasMoveEvent( e ); } @@ -140,6 +147,9 @@ void QgsMapToolAdvancedDigitizing::deactivate() mCadDockWidget->disable(); delete mSnapToGridCanvasItem; mSnapToGridCanvasItem = nullptr; + + if ( mSnapIndicator ) + mSnapIndicator->setMatch( QgsPointLocator::Match() ); } QgsMapLayer *QgsMapToolAdvancedDigitizing::layer() const @@ -147,6 +157,23 @@ QgsMapLayer *QgsMapToolAdvancedDigitizing::layer() const return canvas()->currentLayer(); } +bool QgsMapToolAdvancedDigitizing::useSnappingIndicator() const +{ + return static_cast< bool >( mSnapIndicator.get() ); +} + +void QgsMapToolAdvancedDigitizing::setUseSnappingIndicator( bool enabled ) +{ + if ( enabled && !mSnapIndicator ) + { + mSnapIndicator = std::make_unique< QgsSnapIndicator >( mCanvas ); + } + else if ( !enabled && mSnapIndicator ) + { + mSnapIndicator.reset(); + } +} + void QgsMapToolAdvancedDigitizing::cadPointChanged( const QgsPointXY &point ) { Q_UNUSED( point ) diff --git a/src/gui/qgsmaptooladvanceddigitizing.h b/src/gui/qgsmaptooladvanceddigitizing.h index 752fb19b8a0aa..0d788539e58bc 100644 --- a/src/gui/qgsmaptooladvanceddigitizing.h +++ b/src/gui/qgsmaptooladvanceddigitizing.h @@ -19,10 +19,12 @@ #include "qgsmaptooledit.h" #include "qgis_gui.h" +#include class QgsMapMouseEvent; class QgsAdvancedDigitizingDockWidget; class QgsSnapToGridCanvasItem; +class QgsSnapIndicator; /** * \ingroup gui @@ -44,6 +46,7 @@ class GUI_EXPORT QgsMapToolAdvancedDigitizing : public QgsMapToolEdit * \param cadDockWidget The cad dock widget which will be used to adjust mouse events */ explicit QgsMapToolAdvancedDigitizing( QgsMapCanvas *canvas, QgsAdvancedDigitizingDockWidget *cadDockWidget ); + ~QgsMapToolAdvancedDigitizing() override; //! Catch the mouse press event, filters it, transforms it to map coordinates and send it to virtual method void canvasPressEvent( QgsMapMouseEvent *e ) override; @@ -83,6 +86,9 @@ class GUI_EXPORT QgsMapToolAdvancedDigitizing : public QgsMapToolEdit * * If TRUE is returned, that does not mean that advanced digitizing is actually active, * because it is up to the user to enable/disable it when it is allowed. + * + * The default is that advanced digitizing is allowed. + * * \sa setAdvancedDigitizingAllowed() */ bool isAdvancedDigitizingAllowed() const { return mAdvancedDigitizingAllowed; } @@ -92,15 +98,31 @@ class GUI_EXPORT QgsMapToolAdvancedDigitizing : public QgsMapToolEdit * (according to the snapping configuration of map canvas) before passing the mouse coordinates * to the tool. This may be desirable default behavior for some map tools, but not for other map tools. * It is therefore possible to configure the behavior by the map tool. + * + * The default is that auto snapping is enabled. + * * \sa isAutoSnapEnabled() */ bool isAutoSnapEnabled() const { return mAutoSnapEnabled; } + /** + * Returns whether the snapping indicator should automatically be used. + * + * The default is that a snap indicator is not used. + * + * \see setUseSnappingIndicator() + * \since QGIS 3.40 + */ + bool useSnappingIndicator() const; + protected: /** * Sets whether functionality of advanced digitizing dock widget is currently allowed. * This method is protected because it should be a decision of the map tool and not from elsewhere. + * + * The default is that advanced digitizing is allowed. + * * \sa isAdvancedDigitizingAllowed() */ void setAdvancedDigitizingAllowed( bool allowed ) { mAdvancedDigitizingAllowed = allowed; } @@ -108,10 +130,23 @@ class GUI_EXPORT QgsMapToolAdvancedDigitizing : public QgsMapToolEdit /** * Sets whether mouse events (press/move/release) should automatically try to snap mouse position * This method is protected because it should be a decision of the map tool and not from elsewhere. + * + * The default is that auto snapping is enabled. + * * \sa isAutoSnapEnabled() */ void setAutoSnapEnabled( bool enabled ) { mAutoSnapEnabled = enabled; } + /** + * Sets whether a snapping indicator should automatically be used. + * + * The default is that a snap indicator is not used. + * + * \see useSnappingIndicator() + * \since QGIS 3.40 + */ + void setUseSnappingIndicator( bool enabled ); + QgsAdvancedDigitizingDockWidget *mCadDockWidget = nullptr; @@ -188,6 +223,8 @@ class GUI_EXPORT QgsMapToolAdvancedDigitizing : public QgsMapToolEdit //! Whether to snap to grid before passing coordinates to cadCanvas*Event() bool mSnapToLayerGridEnabled = true; QgsSnapToGridCanvasItem *mSnapToGridCanvasItem = nullptr; + + std::unique_ptr mSnapIndicator; }; #endif // QGSMAPTOOLADVANCEDDIGITIZE_H