QGIS API Documentation  3.2.0-Bonn (bc43194)
qgsmaptip.h
Go to the documentation of this file.
1 /***************************************************************************
2  qgsmaptip.h - Query a layer and show a maptip on the canvas
3  ---------------------
4  begin : October 2007
5  copyright : (C) 2007 by Gary Sherman
6  email : sherman @ mrcc dot com
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 #ifndef QGSMAPTIP_H
16 #define QGSMAPTIP_H
17 
18 class QgsMapLayer;
19 class QgsMapCanvas;
20 class QPoint;
21 class QString;
22 class QgsPointXY;
23 class QgsVectorLayer;
24 class QgsWebView;
25 
26 #include <QWidget>
27 #include <QUrl>
28 #include "qgsfeature.h"
29 #include "qgis_gui.h"
30 
51 class GUI_EXPORT QgsMapTip : public QWidget
52 {
53  Q_OBJECT
54  public:
55 
59  QgsMapTip();
60 
71  void showMapTip( QgsMapLayer *thepLayer,
72  QgsPointXY &mapPosition,
73  QPoint &pixelPosition,
74  QgsMapCanvas *mpMapCanvas );
75 
80  void clear( QgsMapCanvas *mpMapCanvas = nullptr );
81  private:
82  // Fetch the feature to use for the maptip text.
83  // Only the first feature in the search radius is used
84  QString fetchFeature( QgsMapLayer *thepLayer,
85  QgsPointXY &mapPosition,
86  QgsMapCanvas *mapCanvas );
87 
88  QString replaceText(
89  QString displayText, QgsVectorLayer *layer, QgsFeature &feat );
90 
91  // Flag to indicate if a maptip is currently being displayed
92  bool mMapTipVisible;
93 
94  QWidget *mWidget = nullptr;
95  QgsWebView *mWebView = nullptr;
96 
97  private slots:
98  void onLinkClicked( const QUrl &url );
99 };
100 #endif // QGSMAPTIP_H
Base class for all map layer types.
Definition: qgsmaplayer.h:61
A class to represent a 2D point.
Definition: qgspointxy.h:43
The feature class encapsulates a single feature including its id, geometry and a list of field/values...
Definition: qgsfeature.h:62
Map canvas is a class for displaying all GIS data types on a canvas.
Definition: qgsmapcanvas.h:74
The QgsWebView class is a collection of stubs to mimic the API of QWebView on systems where the real ...
Definition: qgswebview.h:65
A maptip is a class to display a tip on a map canvas when a mouse is hovered over a feature...
Definition: qgsmaptip.h:51
Represents a vector layer which manages a vector based data sets.