mirror of
				https://github.com/qgis/QGIS.git
				synced 2025-11-04 00:04:25 -05:00 
			
		
		
		
	
		
			
				
	
	
		
			89 lines
		
	
	
		
			3.5 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			89 lines
		
	
	
		
			3.5 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
/************************************************************************
 | 
						|
 * This file has been generated automatically from                      *
 | 
						|
 *                                                                      *
 | 
						|
 * src/gui/qgsmaptip.h                                                  *
 | 
						|
 *                                                                      *
 | 
						|
 * Do not edit manually ! Edit header and run scripts/sipify.py again   *
 | 
						|
 ************************************************************************/
 | 
						|
 | 
						|
 | 
						|
 | 
						|
class QgsMapTip : QWidget
 | 
						|
{
 | 
						|
%Docstring(signature="appended")
 | 
						|
Displays a tool tip on a map canvas when the mouse is hovered over a
 | 
						|
feature.
 | 
						|
 | 
						|
Since QGIS 2.16 a maptip can show full html. :py:class:`QgsMapTip` is a
 | 
						|
:py:class:`QgsWebView`, so you can load full HTML/JS/CSS in it.
 | 
						|
 | 
						|
The code found in the map tips tab is inserted in a inline-block div so
 | 
						|
the frame can be resized based on the content size.
 | 
						|
 | 
						|
If no element in the html has a width attribute, the frame will squeeze
 | 
						|
down to the widest word. To avoid this you can wrap your HTML in a div
 | 
						|
style="width:300px" or similar.
 | 
						|
 | 
						|
JS can be included using the script tag as usual, while CSS files must
 | 
						|
be linked using link rel="stylesheet" href="URL.css" the html specs
 | 
						|
discourages link rel="stylesheet" in the body, but all browsers allow
 | 
						|
it. see https://jakearchibald.com/2016/link-in-body
 | 
						|
%End
 | 
						|
 | 
						|
%TypeHeaderCode
 | 
						|
#include "qgsmaptip.h"
 | 
						|
%End
 | 
						|
  public:
 | 
						|
    QgsMapTip();
 | 
						|
%Docstring
 | 
						|
Default constructor
 | 
						|
%End
 | 
						|
 | 
						|
    void showMapTip( QgsMapLayer *thepLayer, QgsPointXY &mapPosition, const QPoint &pixelPosition, QgsMapCanvas *mpMapCanvas );
 | 
						|
%Docstring
 | 
						|
Show a maptip at a given point on the map canvas
 | 
						|
 | 
						|
:param thepLayer: a qgis vector map layer pointer that will be used to
 | 
						|
                  provide the attribute data for the map tip.
 | 
						|
:param mapPosition: a reference to the position of the cursor in map
 | 
						|
                    coordinatess.
 | 
						|
:param pixelPosition: a reference to the position of the cursor in pixel
 | 
						|
                      coordinates.
 | 
						|
:param mpMapCanvas: a map canvas on which the tip is drawn
 | 
						|
%End
 | 
						|
 | 
						|
    void clear( QgsMapCanvas *mpMapCanvas = 0, int msDelay = 0 );
 | 
						|
%Docstring
 | 
						|
Clear the current maptip if it exists
 | 
						|
 | 
						|
:param mpMapCanvas: the canvas from which the tip should be cleared.
 | 
						|
:param msDelay: optional time in ms to defer clearing the maptip (since
 | 
						|
                QGIS 3.26)
 | 
						|
%End
 | 
						|
 | 
						|
    static QString vectorMapTipPreviewText( QgsMapLayer *layer, QgsMapCanvas *mapCanvas, const QString &mapTemplate, const QString &displayExpression );
 | 
						|
%Docstring
 | 
						|
Returns the html that would be displayed in a maptip for a given layer.
 | 
						|
If the layer has features, the first feature is used to evaluate the
 | 
						|
expressions.
 | 
						|
 | 
						|
.. versionadded:: 3.32
 | 
						|
%End
 | 
						|
 | 
						|
    static QString rasterMapTipPreviewText( QgsMapLayer *layer, QgsMapCanvas *mapCanvas, const QString &mapTemplate );
 | 
						|
%Docstring
 | 
						|
Returns the html that would be displayed in a maptip for a given layer.
 | 
						|
The center pixel of the raster is used to evaluate the expressions.
 | 
						|
 | 
						|
.. versionadded:: 3.32
 | 
						|
%End
 | 
						|
 | 
						|
};
 | 
						|
/************************************************************************
 | 
						|
 * This file has been generated automatically from                      *
 | 
						|
 *                                                                      *
 | 
						|
 * src/gui/qgsmaptip.h                                                  *
 | 
						|
 *                                                                      *
 | 
						|
 * Do not edit manually ! Edit header and run scripts/sipify.py again   *
 | 
						|
 ************************************************************************/
 |