QGIS API Documentation
3.16.0-Hannover (43b64b13f3)
|
#include <qgspallabeling.h>
Public Member Functions | |
QgsPalLayerSettings () | |
QgsPalLayerSettings (const QgsPalLayerSettings &s) | |
~QgsPalLayerSettings () | |
void | calculateLabelSize (const QFontMetricsF *fm, const QString &text, double &labelX, double &labelY, const QgsFeature *f=nullptr, QgsRenderContext *context=nullptr, double *rotatedLabelX=nullptr, double *rotatedLabelY=nullptr, QgsTextDocument *document=nullptr) |
Calculates the space required to render the provided text in map units. More... | |
QgsCallout * | callout () const |
Returns the label callout renderer, responsible for drawing label callouts. More... | |
QgsPropertyCollection & | dataDefinedProperties () |
Returns a reference to the label's property collection, used for data defined overrides. More... | |
const QgsPropertyCollection & | dataDefinedProperties () const |
Returns a reference to the label's property collection, used for data defined overrides. More... | |
const QgsTextFormat & | format () const |
Returns the label text formatting settings, e.g., font settings, buffer settings, etc. More... | |
QgsExpression * | getLabelExpression () |
Returns the QgsExpression for this label settings. More... | |
QgsLabelLineSettings & | lineSettings () |
Returns the label line settings, which contain settings related to how the label engine places and formats labels for line features (or polygon features which are labeled in a "perimeter" style mode). More... | |
const QgsLabelLineSettings & | lineSettings () const |
Returns the label line settings, which contain settings related to how the label engine places and formats labels for line features (or polygon features which are labeled in a "perimeter" style mode). More... | |
QgsLabelObstacleSettings & | obstacleSettings () |
Returns the label obstacle settings. More... | |
const QgsLabelObstacleSettings & | obstacleSettings () const |
Returns the label obstacle settings. More... | |
QgsPalLayerSettings & | operator= (const QgsPalLayerSettings &s) |
copy operator - only copies the permanent members More... | |
QgsLabeling::PolygonPlacementFlags | polygonPlacementFlags () const |
Returns the polygon placement flags, which dictate how polygon labels can be placed. More... | |
bool | prepare (QgsRenderContext &context, QSet< QString > &attributeNames, const QgsFields &fields, const QgsMapSettings &mapSettings, const QgsCoordinateReferenceSystem &crs) |
Prepare for registration of features. More... | |
void | readXml (const QDomElement &elem, const QgsReadWriteContext &context) |
Read settings from a DOM element. More... | |
QSet< QString > | referencedFields (const QgsRenderContext &context) const |
Returns all field names referenced by the configuration (e.g. More... | |
void | registerFeature (const QgsFeature &f, QgsRenderContext &context, QgsLabelFeature **labelFeature=nullptr, QgsGeometry obstacleGeometry=QgsGeometry(), const QgsSymbol *symbol=nullptr) |
Register a feature for labeling. More... | |
void | setCallout (QgsCallout *callout) |
Sets the label callout renderer, responsible for drawing label callouts. More... | |
void | setDataDefinedProperties (const QgsPropertyCollection &collection) |
Sets the label's property collection, used for data defined overrides. More... | |
void | setFormat (const QgsTextFormat &format) |
Sets the label text formatting settings, e.g., font settings, buffer settings, etc. More... | |
void | setLineSettings (const QgsLabelLineSettings &settings) |
Sets the label line settings, which contain settings related to how the label engine places and formats labels for line features (or polygon features which are labeled in a "perimeter" style mode). More... | |
void | setObstacleSettings (const QgsLabelObstacleSettings &settings) |
Sets the label obstacle settings. More... | |
void | setPolygonPlacementFlags (QgsLabeling::PolygonPlacementFlags flags) |
Sets the polygon placement flags, which dictate how polygon labels can be placed. More... | |
void | setThinningSettings (const QgsLabelThinningSettings &settings) |
Sets the label thinning settings. More... | |
void | startRender (QgsRenderContext &context) |
Prepares the label settings for rendering. More... | |
void | stopRender (QgsRenderContext &context) |
Finalises the label settings after use. More... | |
QgsLabelThinningSettings & | thinningSettings () |
Returns the label thinning settings. More... | |
const QgsLabelThinningSettings & | thinningSettings () const |
Returns the label thinning settings. More... | |
QDomElement | writeXml (QDomDocument &doc, const QgsReadWriteContext &context) const |
Write settings into a DOM element. More... | |
Static Public Member Functions | |
static QPixmap | labelSettingsPreviewPixmap (const QgsPalLayerSettings &settings, QSize size, const QString &previewText=QString(), int padding=0) |
Returns a pixmap preview for label settings. More... | |
static const QgsPropertiesDefinition & | propertyDefinitions () |
Returns the labeling property definitions. More... | |
Public Attributes | |
double | angleOffset = 0 |
Label rotation, in degrees clockwise. More... | |
int | autoWrapLength = 0 |
If non-zero, indicates that label text should be automatically wrapped to (ideally) the specified number of characters. More... | |
bool | centroidInside = false |
true if centroid positioned labels must be placed inside their corresponding feature polygon, or false if centroids which fall outside the polygon are permitted. More... | |
bool | centroidWhole = false |
true if feature centroid should be calculated from the whole feature, or false if only the visible part of the feature should be considered. More... | |
QgsCoordinateTransform | ct |
int | decimals = 3 |
Number of decimal places to show for numeric labels. More... | |
bool | displayAll = false |
If true , all features will be labelled even when overlaps occur. More... | |
double | dist = 0 |
Distance from feature to the label. More... | |
QgsMapUnitScale | distMapUnitScale |
Map unit scale for label feature distance. More... | |
QgsUnitTypes::RenderUnit | distUnits = QgsUnitTypes::RenderMillimeters |
Units the distance from feature to the label. More... | |
bool | drawLabels = true |
Whether to draw labels for this layer. More... | |
QgsGeometry | extentGeom |
int | fieldIndex = 0 |
QString | fieldName |
Name of field (or an expression) to use for label text. More... | |
bool | fitInPolygonOnly = false |
true if only labels which completely fit within a polygon are allowed. More... | |
bool | fontLimitPixelSize = false |
true if label sizes should be limited by pixel size. More... | |
int | fontMaxPixelSize = 10000 |
Maximum pixel size for showing rendered map unit labels (1 - 10000). More... | |
int | fontMinPixelSize = 0 |
Minimum pixel size for showing rendered map unit labels (1 - 1000). More... | |
bool | formatNumbers = false |
Set to true to format numeric label text as numbers (e.g. More... | |
QString | geometryGenerator |
The geometry generator expression. Null if disabled. More... | |
bool | geometryGeneratorEnabled = false |
Defines if the geometry generator is enabled or not. If disabled, the standard geometry will be taken. More... | |
QgsWkbTypes::GeometryType | geometryGeneratorType = QgsWkbTypes::GeometryType::PointGeometry |
The type of the result geometry of the geometry generator. More... | |
bool | isExpression = false |
true if this label is made from a expression string, e.g., FieldName || 'mm' More... | |
QgsMapUnitScale | labelOffsetMapUnitScale |
Map unit scale for label offset. More... | |
bool | labelPerPart = false |
true if every part of a multi-part feature should be labeled. More... | |
QgsWkbTypes::GeometryType | layerType = QgsWkbTypes::UnknownGeometry |
Geometry type of layers associated with these settings. More... | |
double | maxCurvedCharAngleIn = 25.0 |
Maximum angle between inside curved label characters (valid range 20.0 to 60.0). More... | |
double | maxCurvedCharAngleOut = -25.0 |
Maximum angle between outside curved label characters (valid range -20.0 to -95.0) More... | |
double | maximumScale = 0 |
The maximum map scale (i.e. More... | |
const QgsFeature * | mCurFeat = nullptr |
QgsFields | mCurFields |
int | mFeatsRegPal = 0 |
int | mFeatsSendingToPal = 0 |
int | mFeaturesToLabel = 0 |
double | minimumScale = 0 |
The minimum map scale (i.e. More... | |
MultiLineAlign | multilineAlign = MultiFollowPlacement |
Horizontal alignment of multi-line labels. More... | |
OffsetType | offsetType = FromPoint |
Offset type for layer (only applies in certain placement modes) More... | |
QgsUnitTypes::RenderUnit | offsetUnits = QgsUnitTypes::RenderMillimeters |
Units for offsets of label. More... | |
Placement | placement = AroundPoint |
bool | plusSign = false |
Whether '+' signs should be prepended to positive numeric labels. More... | |
QVector< PredefinedPointPosition > | predefinedPositionOrder |
Ordered list of predefined label positions for points. More... | |
bool | preserveRotation = true |
True if label rotation should be preserved during label pin/unpin operations. More... | |
Q_DECL_DEPRECATED QColor | previewBkgrdColor = Qt::white |
int | priority = 5 |
Label priority. More... | |
QgsPointXY | ptOne |
QgsPointXY | ptZero |
QuadrantPosition | quadOffset = QuadrantOver |
Sets the quadrant in which to offset labels from feature. More... | |
double | repeatDistance = 0 |
Distance for repeating labels for a single feature. More... | |
QgsMapUnitScale | repeatDistanceMapUnitScale |
Map unit scale for repeating labels for a single feature. More... | |
QgsUnitTypes::RenderUnit | repeatDistanceUnit = QgsUnitTypes::RenderMillimeters |
Units for repeating labels for a single feature. More... | |
bool | scaleVisibility = false |
Set to true to limit label visibility to a range of scales. More... | |
QgsStringReplacementCollection | substitutions |
Substitution collection for automatic text substitution with labels. More... | |
UpsideDownLabels | upsidedownLabels = Upright |
Controls whether upside down labels are displayed and how they are handled. More... | |
bool | useMaxLineLengthForAutoWrap = true |
If true , indicates that when auto wrapping label text the autoWrapLength length indicates the maximum ideal length of text lines. More... | |
bool | useSubstitutions = false |
True if substitutions should be applied. More... | |
QString | wrapChar |
Wrapping character string. More... | |
const QgsMapToPixel * | xform = nullptr |
double | xOffset = 0 |
Horizontal offset of label. More... | |
double | yOffset = 0 |
Vertical offset of label. More... | |
double | zIndex = 0 |
Z-Index of label, where labels with a higher z-index are rendered on top of labels with a lower z-index. More... | |
Friends | |
class | QgsVectorLayer |
Definition at line 206 of file qgspallabeling.h.
Enumerator | |
---|---|
MultiLeft | |
MultiCenter | |
MultiRight | |
MultiFollowPlacement | Alignment follows placement of label, e.g., labels to the left of a feature will be drawn with right alignment |
MultiJustify | Justified. |
Definition at line 315 of file qgspallabeling.h.
Valid obstacle types, which affect how features within the layer will act as obstacles for labels.
Definition at line 331 of file qgspallabeling.h.
Behavior modifier for label offset and distance, only applies in some label placement modes.
Enumerator | |
---|---|
FromPoint | Offset distance applies from point geometry. |
FromSymbolBounds | Offset distance applies from rendered symbol bounds. |
Definition at line 258 of file qgspallabeling.h.
Placement modes which determine how label candidates are generated for a feature.
Definition at line 221 of file qgspallabeling.h.
Positions for labels when using the QgsPalLabeling::OrderedPositionsAroundPoint placement mode.
Definition at line 236 of file qgspallabeling.h.
Data definable properties.
Definition at line 344 of file qgspallabeling.h.
Enumerator | |
---|---|
QuadrantAboveLeft | |
QuadrantAbove | |
QuadrantAboveRight | |
QuadrantLeft | |
QuadrantOver | |
QuadrantRight | |
QuadrantBelowLeft | |
QuadrantBelow | |
QuadrantBelowRight |
Definition at line 285 of file qgspallabeling.h.
Definition at line 298 of file qgspallabeling.h.
Q_NOWARN_DEPRECATED_PUSH QgsPalLayerSettings::QgsPalLayerSettings | ( | ) |
Definition at line 264 of file qgspallabeling.cpp.
Q_NOWARN_DEPRECATED_POP Q_NOWARN_DEPRECATED_PUSH QgsPalLayerSettings::QgsPalLayerSettings | ( | const QgsPalLayerSettings & | s | ) |
Definition at line 273 of file qgspallabeling.cpp.
QgsPalLayerSettings::~QgsPalLayerSettings | ( | ) |
Definition at line 560 of file qgspallabeling.cpp.
void QgsPalLayerSettings::calculateLabelSize | ( | const QFontMetricsF * | fm, |
const QString & | text, | ||
double & | labelX, | ||
double & | labelY, | ||
const QgsFeature * | f = nullptr , |
||
QgsRenderContext * | context = nullptr , |
||
double * | rotatedLabelX = nullptr , |
||
double * | rotatedLabelY = nullptr , |
||
QgsTextDocument * | document = nullptr |
||
) |
Calculates the space required to render the provided text in map units.
Results will be written to labelX and labelY. If the text orientation is set to rotation-based, the spaced taken to render vertically oriented text will be written to rotatedLabelX and rotatedLabelY .
Definition at line 1385 of file qgspallabeling.cpp.
|
inline |
Returns the label callout renderer, responsible for drawing label callouts.
Ownership is not transferred.
Definition at line 1002 of file qgspallabeling.h.
|
inline |
Returns a reference to the label's property collection, used for data defined overrides.
Definition at line 959 of file qgspallabeling.h.
|
inline |
Returns a reference to the label's property collection, used for data defined overrides.
Definition at line 968 of file qgspallabeling.h.
|
inline |
Returns the label text formatting settings, e.g., font settings, buffer settings, etc.
Definition at line 984 of file qgspallabeling.h.
QgsExpression * QgsPalLayerSettings::getLabelExpression | ( | ) |
Returns the QgsExpression for this label settings.
May be nullptr
if isExpression is false
.
Definition at line 579 of file qgspallabeling.cpp.
|
static |
Returns a pixmap preview for label settings.
settings | label settings |
size | target pixmap size |
previewText | text to render in preview, or empty for default text |
padding | space between icon edge and color ramp |
Definition at line 1256 of file qgspallabeling.cpp.
|
inline |
Returns the label line settings, which contain settings related to how the label engine places and formats labels for line features (or polygon features which are labeled in a "perimeter" style mode).
Definition at line 1031 of file qgspallabeling.h.
|
inline |
Returns the label line settings, which contain settings related to how the label engine places and formats labels for line features (or polygon features which are labeled in a "perimeter" style mode).
Definition at line 1022 of file qgspallabeling.h.
|
inline |
Returns the label obstacle settings.
Definition at line 1055 of file qgspallabeling.h.
|
inline |
Returns the label obstacle settings.
Definition at line 1048 of file qgspallabeling.h.
Q_NOWARN_DEPRECATED_POP QgsPalLayerSettings & QgsPalLayerSettings::operator= | ( | const QgsPalLayerSettings & | s | ) |
copy operator - only copies the permanent members
Definition at line 281 of file qgspallabeling.cpp.
|
inline |
Returns the polygon placement flags, which dictate how polygon labels can be placed.
Definition at line 626 of file qgspallabeling.h.
bool QgsPalLayerSettings::prepare | ( | QgsRenderContext & | context, |
QSet< QString > & | attributeNames, | ||
const QgsFields & | fields, | ||
const QgsMapSettings & | mapSettings, | ||
const QgsCoordinateReferenceSystem & | crs | ||
) |
Prepare for registration of features.
The context, mapSettings and fields parameters give more information about the rendering environment. If target crs is not specified, the targetCrs from mapSettings will be taken. The parameter attributeNames should be updated to contain all the field names which the labeling requires for the rendering.
Definition at line 363 of file qgspallabeling.cpp.
|
static |
Returns the labeling property definitions.
Definition at line 573 of file qgspallabeling.cpp.
void QgsPalLayerSettings::readXml | ( | const QDomElement & | elem, |
const QgsReadWriteContext & | context | ||
) |
QSet< QString > QgsPalLayerSettings::referencedFields | ( | const QgsRenderContext & | context | ) | const |
Returns all field names referenced by the configuration (e.g.
field name or expression, data defined properties).
Definition at line 485 of file qgspallabeling.cpp.
void QgsPalLayerSettings::registerFeature | ( | const QgsFeature & | f, |
QgsRenderContext & | context, | ||
QgsLabelFeature ** | labelFeature = nullptr , |
||
QgsGeometry | obstacleGeometry = QgsGeometry() , |
||
const QgsSymbol * | symbol = nullptr |
||
) |
Register a feature for labeling.
f | feature to label |
context | render context. The QgsExpressionContext contained within the render context must have already had the feature and fields sets prior to calling this method. |
labelFeature | if using QgsLabelingEngine, this will receive the label feature. Not available in Python bindings. |
obstacleGeometry | optional obstacle geometry, if a different geometry to the feature's geometry should be used as an obstacle for labels (e.g., if the feature has been rendered with an offset point symbol, the obstacle geometry should represent the bounds of the offset symbol). If not set, the feature's original geometry will be used as an obstacle for labels. Not available in Python bindings. |
symbol | feature symbol to label (ownership is not transferred, and symbol must exist until the labeling is complete) |
Definition at line 1648 of file qgspallabeling.cpp.
void QgsPalLayerSettings::setCallout | ( | QgsCallout * | callout | ) |
Sets the label callout renderer, responsible for drawing label callouts.
Ownership of callout is transferred to the settings.
Definition at line 1251 of file qgspallabeling.cpp.
|
inline |
Sets the label's property collection, used for data defined overrides.
collection | property collection. Existing properties will be replaced. |
Definition at line 977 of file qgspallabeling.h.
|
inline |
Sets the label text formatting settings, e.g., font settings, buffer settings, etc.
format | label text format |
Definition at line 992 of file qgspallabeling.h.
|
inline |
Sets the label line settings, which contain settings related to how the label engine places and formats labels for line features (or polygon features which are labeled in a "perimeter" style mode).
Definition at line 1040 of file qgspallabeling.h.
|
inline |
Sets the label obstacle settings.
Definition at line 1062 of file qgspallabeling.h.
|
inline |
Sets the polygon placement flags, which dictate how polygon labels can be placed.
Definition at line 634 of file qgspallabeling.h.
|
inline |
Sets the label thinning settings.
Definition at line 1084 of file qgspallabeling.h.
void QgsPalLayerSettings::startRender | ( | QgsRenderContext & | context | ) |
Prepares the label settings for rendering.
This should be called before rendering any labels, and must be followed by a call to stopRender() in order to gracefully clean up symbols.
Definition at line 521 of file qgspallabeling.cpp.
void QgsPalLayerSettings::stopRender | ( | QgsRenderContext & | context | ) |
Finalises the label settings after use.
This must be called after a call to startRender(), in order to gracefully clean up symbols.
Definition at line 544 of file qgspallabeling.cpp.
|
inline |
Returns the label thinning settings.
Definition at line 1077 of file qgspallabeling.h.
|
inline |
Returns the label thinning settings.
Definition at line 1070 of file qgspallabeling.h.
QDomElement QgsPalLayerSettings::writeXml | ( | QDomDocument & | doc, |
const QgsReadWriteContext & | context | ||
) | const |
Write settings into a DOM element.
Definition at line 1144 of file qgspallabeling.cpp.
|
friend |
Definition at line 1111 of file qgspallabeling.h.
double QgsPalLayerSettings::angleOffset = 0 |
Label rotation, in degrees clockwise.
Definition at line 745 of file qgspallabeling.h.
int QgsPalLayerSettings::autoWrapLength = 0 |
If non-zero, indicates that label text should be automatically wrapped to (ideally) the specified number of characters.
If zero, auto wrapping is disabled.
Definition at line 577 of file qgspallabeling.h.
bool QgsPalLayerSettings::centroidInside = false |
true
if centroid positioned labels must be placed inside their corresponding feature polygon, or false
if centroids which fall outside the polygon are permitted.
Definition at line 647 of file qgspallabeling.h.
bool QgsPalLayerSettings::centroidWhole = false |
true
if feature centroid should be calculated from the whole feature, or false
if only the visible part of the feature should be considered.
Definition at line 640 of file qgspallabeling.h.
QgsCoordinateTransform QgsPalLayerSettings::ct |
Definition at line 1101 of file qgspallabeling.h.
int QgsPalLayerSettings::decimals = 3 |
Number of decimal places to show for numeric labels.
formatNumbers must be true
for this setting to have an effect.
Definition at line 607 of file qgspallabeling.h.
bool QgsPalLayerSettings::displayAll = false |
If true
, all features will be labelled even when overlaps occur.
Definition at line 823 of file qgspallabeling.h.
double QgsPalLayerSettings::dist = 0 |
Distance from feature to the label.
Units are specified via distUnits.
Definition at line 667 of file qgspallabeling.h.
QgsMapUnitScale QgsPalLayerSettings::distMapUnitScale |
Map unit scale for label feature distance.
Definition at line 681 of file qgspallabeling.h.
QgsUnitTypes::RenderUnit QgsPalLayerSettings::distUnits = QgsUnitTypes::RenderMillimeters |
Units the distance from feature to the label.
Definition at line 674 of file qgspallabeling.h.
bool QgsPalLayerSettings::drawLabels = true |
Whether to draw labels for this layer.
For some layers it may be desirable to register their features as obstacles for other labels without requiring labels to be drawn for the layer itself. In this case drawLabels can be set to false
and obstacle set to true
, which will result in the layer acting as an obstacle but having no labels of its own.
Definition at line 530 of file qgspallabeling.h.
QgsGeometry QgsPalLayerSettings::extentGeom |
Definition at line 1105 of file qgspallabeling.h.
int QgsPalLayerSettings::fieldIndex = 0 |
Definition at line 1099 of file qgspallabeling.h.
QString QgsPalLayerSettings::fieldName |
Name of field (or an expression) to use for label text.
If fieldName is an expression, then isExpression should be set to true
.
Definition at line 539 of file qgspallabeling.h.
bool QgsPalLayerSettings::fitInPolygonOnly = false |
true
if only labels which completely fit within a polygon are allowed.
Definition at line 660 of file qgspallabeling.h.
bool QgsPalLayerSettings::fontLimitPixelSize = false |
true
if label sizes should be limited by pixel size.
Definition at line 806 of file qgspallabeling.h.
int QgsPalLayerSettings::fontMaxPixelSize = 10000 |
Maximum pixel size for showing rendered map unit labels (1 - 10000).
Definition at line 820 of file qgspallabeling.h.
int QgsPalLayerSettings::fontMinPixelSize = 0 |
Minimum pixel size for showing rendered map unit labels (1 - 1000).
Definition at line 813 of file qgspallabeling.h.
bool QgsPalLayerSettings::formatNumbers = false |
Set to true
to format numeric label text as numbers (e.g.
inserting thousand separators and fixed number of decimal places).
Definition at line 600 of file qgspallabeling.h.
QString QgsPalLayerSettings::geometryGenerator |
The geometry generator expression. Null if disabled.
Definition at line 897 of file qgspallabeling.h.
bool QgsPalLayerSettings::geometryGeneratorEnabled = false |
Defines if the geometry generator is enabled or not. If disabled, the standard geometry will be taken.
Definition at line 903 of file qgspallabeling.h.
QgsWkbTypes::GeometryType QgsPalLayerSettings::geometryGeneratorType = QgsWkbTypes::GeometryType::PointGeometry |
The type of the result geometry of the geometry generator.
Definition at line 900 of file qgspallabeling.h.
bool QgsPalLayerSettings::isExpression = false |
true
if this label is made from a expression string, e.g., FieldName || 'mm'
Definition at line 545 of file qgspallabeling.h.
QgsMapUnitScale QgsPalLayerSettings::labelOffsetMapUnitScale |
Map unit scale for label offset.
Definition at line 742 of file qgspallabeling.h.
bool QgsPalLayerSettings::labelPerPart = false |
true
if every part of a multi-part feature should be labeled.
If false
, only the largest part will be labeled.
Definition at line 832 of file qgspallabeling.h.
QgsWkbTypes::GeometryType QgsPalLayerSettings::layerType = QgsWkbTypes::UnknownGeometry |
Geometry type of layers associated with these settings.
Definition at line 909 of file qgspallabeling.h.
double QgsPalLayerSettings::maxCurvedCharAngleIn = 25.0 |
Maximum angle between inside curved label characters (valid range 20.0 to 60.0).
Definition at line 754 of file qgspallabeling.h.
double QgsPalLayerSettings::maxCurvedCharAngleOut = -25.0 |
Maximum angle between outside curved label characters (valid range -20.0 to -95.0)
Definition at line 760 of file qgspallabeling.h.
double QgsPalLayerSettings::maximumScale = 0 |
The maximum map scale (i.e.
most "zoomed in" scale) at which the labels will be visible. The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map. A scale of 0 indicates no maximum scale visibility.
This setting is only considered if scaleVisibility is true
.
Definition at line 787 of file qgspallabeling.h.
const QgsFeature* QgsPalLayerSettings::mCurFeat = nullptr |
Definition at line 1097 of file qgspallabeling.h.
QgsFields QgsPalLayerSettings::mCurFields |
Definition at line 1098 of file qgspallabeling.h.
int QgsPalLayerSettings::mFeatsRegPal = 0 |
Definition at line 1108 of file qgspallabeling.h.
int QgsPalLayerSettings::mFeatsSendingToPal = 0 |
Definition at line 1107 of file qgspallabeling.h.
int QgsPalLayerSettings::mFeaturesToLabel = 0 |
Definition at line 1106 of file qgspallabeling.h.
double QgsPalLayerSettings::minimumScale = 0 |
The minimum map scale (i.e.
most "zoomed out" scale) at which the labels will be visible. The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map. A scale of 0 indicates no minimum scale visibility.
This setting is only considered if scaleVisibility is true
.
Definition at line 799 of file qgspallabeling.h.
MultiLineAlign QgsPalLayerSettings::multilineAlign = MultiFollowPlacement |
Horizontal alignment of multi-line labels.
Definition at line 592 of file qgspallabeling.h.
OffsetType QgsPalLayerSettings::offsetType = FromPoint |
Offset type for layer (only applies in certain placement modes)
Definition at line 684 of file qgspallabeling.h.
QgsUnitTypes::RenderUnit QgsPalLayerSettings::offsetUnits = QgsUnitTypes::RenderMillimeters |
Units for offsets of label.
Definition at line 734 of file qgspallabeling.h.
Placement QgsPalLayerSettings::placement = AroundPoint |
Definition at line 618 of file qgspallabeling.h.
bool QgsPalLayerSettings::plusSign = false |
Whether '+' signs should be prepended to positive numeric labels.
formatNumbers must be true
for this setting to have an effect.
Definition at line 614 of file qgspallabeling.h.
QVector< PredefinedPointPosition > QgsPalLayerSettings::predefinedPositionOrder |
Ordered list of predefined label positions for points.
Positions earlier in the list will be prioritized over later positions. Only used when the placement is set to QgsPalLayerSettings::OrderedPositionsAroundPoint.
Definition at line 655 of file qgspallabeling.h.
bool QgsPalLayerSettings::preserveRotation = true |
True if label rotation should be preserved during label pin/unpin operations.
Definition at line 748 of file qgspallabeling.h.
Q_DECL_DEPRECATED QColor QgsPalLayerSettings::previewBkgrdColor = Qt::white |
Definition at line 555 of file qgspallabeling.h.
int QgsPalLayerSettings::priority = 5 |
Label priority.
Valid ranges are from 0 to 10, where 0 = lowest priority and 10 = highest priority.
Definition at line 766 of file qgspallabeling.h.
QgsPointXY QgsPalLayerSettings::ptOne |
Definition at line 1104 of file qgspallabeling.h.
QgsPointXY QgsPalLayerSettings::ptZero |
Definition at line 1103 of file qgspallabeling.h.
QuadrantPosition QgsPalLayerSettings::quadOffset = QuadrantOver |
Sets the quadrant in which to offset labels from feature.
Definition at line 710 of file qgspallabeling.h.
double QgsPalLayerSettings::repeatDistance = 0 |
Distance for repeating labels for a single feature.
Definition at line 691 of file qgspallabeling.h.
QgsMapUnitScale QgsPalLayerSettings::repeatDistanceMapUnitScale |
Map unit scale for repeating labels for a single feature.
Definition at line 705 of file qgspallabeling.h.
QgsUnitTypes::RenderUnit QgsPalLayerSettings::repeatDistanceUnit = QgsUnitTypes::RenderMillimeters |
Units for repeating labels for a single feature.
Definition at line 698 of file qgspallabeling.h.
bool QgsPalLayerSettings::scaleVisibility = false |
Set to true
to limit label visibility to a range of scales.
Definition at line 775 of file qgspallabeling.h.
QgsStringReplacementCollection QgsPalLayerSettings::substitutions |
Substitution collection for automatic text substitution with labels.
Definition at line 558 of file qgspallabeling.h.
UpsideDownLabels QgsPalLayerSettings::upsidedownLabels = Upright |
Controls whether upside down labels are displayed and how they are handled.
Definition at line 826 of file qgspallabeling.h.
bool QgsPalLayerSettings::useMaxLineLengthForAutoWrap = true |
If true
, indicates that when auto wrapping label text the autoWrapLength length indicates the maximum ideal length of text lines.
If false
, then autoWrapLength indicates the ideal minimum length of text lines.
If autoWrapLength is 0 then this value has no effect.
Definition at line 589 of file qgspallabeling.h.
bool QgsPalLayerSettings::useSubstitutions = false |
True if substitutions should be applied.
Definition at line 560 of file qgspallabeling.h.
QString QgsPalLayerSettings::wrapChar |
Wrapping character string.
If set, any occurrences of this string in the calculated label text will be replaced with new line characters.
Definition at line 568 of file qgspallabeling.h.
const QgsMapToPixel* QgsPalLayerSettings::xform = nullptr |
Definition at line 1100 of file qgspallabeling.h.
double QgsPalLayerSettings::xOffset = 0 |
Horizontal offset of label.
Units are specified via offsetUnits.
Definition at line 718 of file qgspallabeling.h.
double QgsPalLayerSettings::yOffset = 0 |
Vertical offset of label.
Units are specified via offsetUnits.
Definition at line 726 of file qgspallabeling.h.
double QgsPalLayerSettings::zIndex = 0 |
Z-Index of label, where labels with a higher z-index are rendered on top of labels with a lower z-index.
Definition at line 894 of file qgspallabeling.h.