QGIS API Documentation 3.28.0-Firenze (ed3ad0430f)
qgsmapmouseevent.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsmapmouseevent.h - mouse event in map coordinates and ability to snap
3 ----------------------
4 begin : October 2014
5 copyright : (C) Denis Rouzaud
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
16#ifndef QGSMAPMOUSEEVENT_H
17#define QGSMAPMOUSEEVENT_H
18
19#include <QMouseEvent>
20
21#include "qgspointxy.h"
22#include "qgspointlocator.h"
23#include "qgis_gui.h"
24
25class QgsMapCanvas;
27
35class GUI_EXPORT QgsMapMouseEvent : public QMouseEvent
36{
37
38#ifdef SIP_RUN
40 if ( dynamic_cast<QgsMapMouseEvent *>( sipCpp ) )
41 sipType = sipType_QgsMapMouseEvent;
42 else
43 sipType = 0;
45#endif
46
47 public:
48
55 QgsMapMouseEvent( QgsMapCanvas *mapCanvas, QMouseEvent *event );
56
67 QgsMapMouseEvent( QgsMapCanvas *mapCanvas, QEvent::Type type, QPoint pos, Qt::MouseButton button = Qt::NoButton,
68 Qt::MouseButtons buttons = Qt::NoButton, Qt::KeyboardModifiers modifiers = Qt::NoModifier );
69
74 QgsPointXY snapPoint();
75
82 bool isSnapped() const { return mSnapMatch.isValid(); }
83
88 inline QgsPointXY mapPoint() const { return mMapPoint; }
89
97 QgsPointLocator::Match mapPointMatch() const { return mSnapMatch; }
98
105 void setMapPoint( const QgsPointXY &point );
106
112 QgsPointXY originalMapPoint() const { return mMapPoint; }
113
119 QPoint pixelPoint() const { return mPixelPoint; }
120
127 QPoint originalPixelPoint() const { return pos(); }
128
136 void snapToGrid( double precision, const QgsCoordinateReferenceSystem &crs );
137
138 private:
139
140 QPoint mapToPixelCoordinates( const QgsPointXY &point );
141
143 bool mHasCachedSnapResult;
144
146 QgsPointXY mOriginalMapPoint;
147
149 QgsPointXY mMapPoint;
150
155 QPoint mPixelPoint;
156
158 QgsMapCanvas *mMapCanvas = nullptr;
159
160 QgsPointLocator::Match mSnapMatch;
161};
162
163#endif // QGSMAPMOUSEEVENT_H
This class represents a coordinate reference system (CRS).
Map canvas is a class for displaying all GIS data types on a canvas.
Definition: qgsmapcanvas.h:90
A QgsMapMouseEvent is the result of a user interaction with the mouse on a QgsMapCanvas.
QPoint originalPixelPoint() const
The unsnapped, real mouse cursor position in pixel coordinates.
QgsPointXY originalMapPoint() const
Returns the original, unmodified map point of the mouse cursor.
bool isSnapped() const
Returns true if there is a snapped point cached.
QgsPointXY mapPoint() const
mapPoint returns the point in coordinates
QPoint pixelPoint() const
The snapped mouse cursor in pixel coordinates.
QgsPointLocator::Match mapPointMatch() const
Returns the matching data from the most recently snapped point.
The QgsMapToolAdvancedDigitizing class is a QgsMapTool which gives event directly in map coordinates ...
A class to represent a 2D point.
Definition: qgspointxy.h:59
#define SIP_CONVERT_TO_SUBCLASS_CODE(code)
Definition: qgis_sip.h:186
#define SIP_END
Definition: qgis_sip.h:203
const QgsCoordinateReferenceSystem & crs
int precision