QGIS API Documentation 3.39.0-Master (3aed037ce22)
Loading...
Searching...
No Matches
qgslabelinggui.h
Go to the documentation of this file.
1/***************************************************************************
2 qgslabelinggui.h
3 Smart labeling for vector layers
4 -------------------
5 begin : June 2009
6 copyright : (C) Martin Dobias
7 email : wonder dot sk at gmail dot com
8
9 ***************************************************************************
10 * *
11 * This program is free software; you can redistribute it and/or modify *
12 * it under the terms of the GNU General Public License as published by *
13 * the Free Software Foundation; either version 2 of the License, or *
14 * (at your option) any later version. *
15 * *
16 ***************************************************************************/
17
18#ifndef QGSLABELINGGUI_H
19#define QGSLABELINGGUI_H
20
21#include "qgspallabeling.h"
22#include "qgstextformatwidget.h"
24#include "qgis_gui.h"
25
26class QDialogButtonBox;
27
28#define SIP_NO_FILE
29
31
32class GUI_EXPORT QgsLabelingGui : public QgsTextFormatWidget
33{
34 Q_OBJECT
35
36 public:
37 QgsLabelingGui( QgsMapLayer *layer, QgsMapCanvas *mapCanvas, const QgsPalLayerSettings &settings, QWidget *parent = nullptr,
39
40 QgsPalLayerSettings layerSettings();
41
42 enum LabelMode
43 {
44 NoLabels,
45 Labels,
46 ObstaclesOnly,
47 };
48
49 void setLabelMode( LabelMode mode );
50
51 void setLayer( QgsMapLayer *layer );
52
53 void setSettings( const QgsPalLayerSettings &settings );
54
55 void setContext( const QgsSymbolWidgetContext &context ) override;
56
57 public slots:
58
59 void updateUi();
60
61 protected slots:
62 void setFormatFromStyle( const QString &name, QgsStyle::StyleEntity type, const QString &stylePath ) override;
63 void saveFormat() override;
64
65 protected:
66 void blockInitSignals( bool block );
67 void syncDefinedCheckboxFrame( QgsPropertyOverrideButton *ddBtn, QCheckBox *chkBx, QFrame *f );
68 bool eventFilter( QObject *object, QEvent *event ) override;
69
70 private slots:
71
77 void updateGeometryTypeBasedWidgets();
78 void showGeometryGeneratorExpressionBuilder();
79 void validateGeometryGeneratorExpression();
80 void determineGeometryGeneratorType();
81
85 void calloutTypeChanged();
86
87 private:
88
89 QgsPalLayerSettings mSettings;
90 LabelMode mMode;
91 QgsFeature mPreviewFeature;
92 QgsMapCanvas *mCanvas = nullptr;
93
94 QgsLabelObstacleSettings mObstacleSettings;
95 QgsLabelLineSettings mLineSettings;
96
98
99 private slots:
100
101 void updateCalloutWidget( QgsCallout *callout );
102 void showObstacleSettings();
103 void showLineAnchorSettings();
104
105};
106
107class GUI_EXPORT QgsLabelSettingsDialog : public QDialog
108{
109 Q_OBJECT
110
111 public:
112
113 QgsLabelSettingsDialog( const QgsPalLayerSettings &settings, QgsVectorLayer *layer, QgsMapCanvas *mapCanvas, QWidget *parent SIP_TRANSFERTHIS = nullptr,
115
116 QgsPalLayerSettings settings() const { return mWidget->layerSettings(); }
117
121 QDialogButtonBox *buttonBox() const;
122
123 private:
124
125 QgsLabelingGui *mWidget = nullptr;
126 QDialogButtonBox *mButtonBox = nullptr;
127
128 private slots:
129 void showHelp();
130
131};
132
134
135#endif // QGSLABELINGGUI_H
136
137
GeometryType
The geometry types are used to group Qgis::WkbType in a coarse way.
Definition qgis.h:274
@ Unknown
Unknown types.
Abstract base class for callout renderers.
Definition qgscallout.h:53
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition qgsfeature.h:58
Contains settings related to how the label engine places and formats labels for line features (or pol...
Contains settings related to how the label engine treats features as obstacles.
Map canvas is a class for displaying all GIS data types on a canvas.
Base class for all map layer types.
Definition qgsmaplayer.h:75
Contains settings for how a map layer will be labeled.
A button for controlling property overrides which may apply to a widget.
StyleEntity
Enum for Entities involved in a style.
Definition qgsstyle.h:183
Contains settings which reflect the context in which a symbol (or renderer) widget is shown,...
A widget for customizing text formatting settings.
QgsExpressionContext createExpressionContext() const override
This method needs to be reimplemented in all classes which implement this interface and return an exp...
virtual void setContext(const QgsSymbolWidgetContext &context)
Sets the context in which the widget is shown, e.g., the associated map canvas and expression context...
virtual void setFormatFromStyle(const QString &name, QgsStyle::StyleEntity type, const QString &stylePath)
Sets the current text settings from a style entry.
virtual void saveFormat()
Saves the current text settings to a style entry.
Represents a vector layer which manages a vector based data sets.
#define SIP_TRANSFERTHIS
Definition qgis_sip.h:53