A labeling engine rule which prevents labels being placed too far from features from a different layer. More...

#include <qgslabelingenginerule_impl.h>

Inheritance diagram for QgsLabelingEngineRuleMaximumDistanceLabelToFeature:

[legend]

Public Member Functions
	QgsLabelingEngineRuleMaximumDistanceLabelToFeature ()

	~QgsLabelingEngineRuleMaximumDistanceLabelToFeature () override

QgsLabelingEngineRuleMaximumDistanceLabelToFeature *	clone () const override
	Creates a clone of this rule.

QString	description () const override
	Returns a user-friendly description of the rule.

QString	displayType () const override
	Returns a user-friendly, translated string representing the rule type.

QString	id () const override
	Returns a string uniquely identifying the rule subclass.

Public Member Functions inherited from QgsAbstractLabelingEngineRuleDistanceFromFeature
	QgsAbstractLabelingEngineRuleDistanceFromFeature ()

	~QgsAbstractLabelingEngineRuleDistanceFromFeature () override

void	alterCandidateCost (pal::LabelPosition *candidate, QgsLabelingEngineContext &context) const override
	Provides an opportunity for the rule to alter the cost for a candidate.

bool	candidateIsIllegal (const pal::LabelPosition *candidate, QgsLabelingEngineContext &context) const override
	Returns `true` if a labeling candidate violates the rule and should be eliminated.

double	cost () const
	Returns the penalty cost incurred when the rule is violated.

double	distance () const
	Returns the acceptable distance threshold between labels and the features from the targetLayer().

Qgis::RenderUnit	distanceUnit () const
	Returns the units for the distance between labels and the features from the targetLayer().

const QgsMapUnitScale &	distanceUnitScale () const
	Returns the scaling for the distance between labels and the features from the targetLayer().

bool	isAvailable () const override
	Returns `true` if the rule is available for use within the current QGIS environment.

QgsMapLayer *	labeledLayer () const
	Returns the layer providing the labels.

bool	prepare (QgsRenderContext &context) override
	Prepares the rule.

void	readXml (const QDomElement &element, const QgsReadWriteContext &context) override
	Reads the rule properties from an XML element.

void	resolveReferences (const QgsProject *project) override
	Resolves reference to layers from stored layer ID.

void	setCost (double cost)
	Sets the penalty cost incurred when the rule is violated.

void	setDistance (double distance)
	Sets the acceptable distance threshold between labels and the features from the targetLayer().

void	setDistanceUnit (Qgis::RenderUnit unit)
	Sets the unit for the distance between labels and the features from the targetLayer().

void	setDistanceUnitScale (const QgsMapUnitScale &scale)
	Sets the scale for the distance between labels and the features from the targetLayer().

void	setLabeledLayer (QgsMapLayer *layer)
	Sets the layer providing the labels.

void	setTargetLayer (QgsVectorLayer *layer)
	Sets the layer providing the features which labels must be distant from (or close to).

QgsVectorLayer *	targetLayer () const
	Returns the layer providing the features which labels must be distant from (or close to).

void	writeXml (QDomDocument &doc, QDomElement &element, const QgsReadWriteContext &context) const override
	Writes the rule properties to an XML element.

Public Member Functions inherited from QgsAbstractLabelingEngineRule
virtual	~QgsAbstractLabelingEngineRule ()

bool	active () const
	Returns `true` if the rule is active.

virtual bool	candidatesAreConflicting (const pal::LabelPosition lp1, const pal::LabelPosition lp2) const
	Returns `true` if a labeling candidate lp1 conflicts with lp2 after applying the rule.

virtual QgsRectangle	modifyCandidateConflictSearchBoundingBox (const QgsRectangle &candidateBounds) const
	Returns a (possibly expanded) bounding box to use when searching for conflicts for a candidate.

QString	name () const
	Returns the name for this instance of the rule.

void	setActive (bool active)
	Sets whether the rule is active.

void	setName (const QString &name)
	Sets the name for this instance of the rule.

Additional Inherited Members
Protected Member Functions inherited from QgsAbstractLabelingEngineRuleDistanceFromFeature
void	copyCommonProperties (QgsAbstractLabelingEngineRule *other) const override
	Copies common properties from this object to an other.

Protected Attributes inherited from QgsAbstractLabelingEngineRuleDistanceFromFeature
bool	mMustBeDistant = true
	`true` if labels must be distant from features, `false` if they must be close

Detailed Description

A labeling engine rule which prevents labels being placed too far from features from a different layer.

Since: QGIS 3.40

Definition at line 225 of file qgslabelingenginerule_impl.h.

Constructor & Destructor Documentation

◆ QgsLabelingEngineRuleMaximumDistanceLabelToFeature()

QgsLabelingEngineRuleMaximumDistanceLabelToFeature::QgsLabelingEngineRuleMaximumDistanceLabelToFeature ( )

Definition at line 282 of file qgslabelingenginerule_impl.cpp.

◆ ~QgsLabelingEngineRuleMaximumDistanceLabelToFeature()

QgsLabelingEngineRuleMaximumDistanceLabelToFeature::~QgsLabelingEngineRuleMaximumDistanceLabelToFeature ( )

overridedefault

Member Function Documentation

◆ clone()

QgsLabelingEngineRuleMaximumDistanceLabelToFeature * QgsLabelingEngineRuleMaximumDistanceLabelToFeature::clone ( ) const

overridevirtual

Creates a clone of this rule.

The caller takes ownership of the returned object.

Implements QgsAbstractLabelingEngineRule.

Definition at line 289 of file qgslabelingenginerule_impl.cpp.

◆ description()

QString QgsLabelingEngineRuleMaximumDistanceLabelToFeature::description ( ) const

overridevirtual

Returns a user-friendly description of the rule.

This should include the rule name() if set, and other useful details for users to quickly identify the rule's purpose when shown in a tooltip.

The returned string may contain HTML formatting.

Reimplemented from QgsAbstractLabelingEngineRule.

Definition at line 306 of file qgslabelingenginerule_impl.cpp.

◆ displayType()

QString QgsLabelingEngineRuleMaximumDistanceLabelToFeature::displayType ( ) const

overridevirtual

Returns a user-friendly, translated string representing the rule type.

Implements QgsAbstractLabelingEngineRule.

Definition at line 301 of file qgslabelingenginerule_impl.cpp.

◆ id()

QString QgsLabelingEngineRuleMaximumDistanceLabelToFeature::id ( ) const

overridevirtual

Returns a string uniquely identifying the rule subclass.

Implements QgsAbstractLabelingEngineRule.

Definition at line 296 of file qgslabelingenginerule_impl.cpp.

The documentation for this class was generated from the following files:

/build/qgis-3.99.0+git20250718+f78f5286a64+99sid/src/core/labeling/rules/qgslabelingenginerule_impl.h
/build/qgis-3.99.0+git20250718+f78f5286a64+99sid/src/core/labeling/rules/qgslabelingenginerule_impl.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ QgsLabelingEngineRuleMaximumDistanceLabelToFeature()

◆ ~QgsLabelingEngineRuleMaximumDistanceLabelToFeature()

Member Function Documentation

◆ clone()

◆ description()

◆ displayType()

◆ id()