QGIS API Documentation  3.14.0-Pi (9f7028fd23)
Public Member Functions | Static Public Member Functions | Protected Member Functions | List of all members
QgsManhattanLineCallout Class Reference

Draws straight (right angled) lines as callouts. More...

#include <qgscallout.h>

Inheritance diagram for QgsManhattanLineCallout:
Inheritance graph
[legend]

Public Member Functions

 QgsManhattanLineCallout ()
 
 QgsManhattanLineCallout (const QgsManhattanLineCallout &other)
 Copy constructor. More...
 
QgsManhattanLineCalloutclone () const override
 Duplicates a callout by creating a deep copy of the callout. More...
 
QgsManhattanLineCalloutoperator= (const QgsManhattanLineCallout &)=delete
 
QString type () const override
 Returns a unique string representing the callout type. More...
 
- Public Member Functions inherited from QgsSimpleLineCallout
 QgsSimpleLineCallout ()
 
 QgsSimpleLineCallout (const QgsSimpleLineCallout &other)
 Copy constructor. More...
 
 ~QgsSimpleLineCallout () override
 
bool drawCalloutToAllParts () const
 Returns true if callout lines should be drawn to all feature parts. More...
 
QgsLineSymbollineSymbol ()
 Returns the line symbol used to render the callout line. More...
 
double minimumLength () const
 Returns the minimum length of callout lines. More...
 
const QgsMapUnitScaleminimumLengthMapUnitScale () const
 Returns the map unit scale for the minimum callout length. More...
 
QgsUnitTypes::RenderUnit minimumLengthUnit () const
 Returns the units for the minimum length of callout lines. More...
 
double offsetFromAnchor () const
 Returns the offset distance from the anchor point at which to start the line. More...
 
const QgsMapUnitScaleoffsetFromAnchorMapUnitScale () const
 Returns the map unit scale for the offset from anchor. More...
 
QgsUnitTypes::RenderUnit offsetFromAnchorUnit () const
 Returns the units for the offset from anchor point. More...
 
double offsetFromLabel () const
 Returns the offset distance from label area at which to end the line. More...
 
const QgsMapUnitScaleoffsetFromLabelMapUnitScale () const
 Returns the map unit scale for the minimum callout length. More...
 
QgsUnitTypes::RenderUnit offsetFromLabelUnit () const
 Returns the units for the offset from label area. More...
 
QgsSimpleLineCalloutoperator= (const QgsSimpleLineCallout &)=delete
 
QVariantMap properties (const QgsReadWriteContext &context) const override
 Returns the properties describing the callout encoded in a string format. More...
 
void readProperties (const QVariantMap &props, const QgsReadWriteContext &context) override
 Reads a string map of an callout's properties and restores the callout to the state described by the properties map. More...
 
QSet< QString > referencedFields (const QgsRenderContext &context) const override
 Returns the set of attributes referenced by the callout. More...
 
void setDrawCalloutToAllParts (bool drawToAllParts)
 Sets whether callout lines should be drawn to all feature parts. More...
 
void setLineSymbol (QgsLineSymbol *symbol)
 Sets the line symbol used to render the callout line. More...
 
void setMinimumLength (double length)
 Sets the minimum length of callout lines. More...
 
void setMinimumLengthMapUnitScale (const QgsMapUnitScale &scale)
 Sets the map unit scale for the minimum callout length. More...
 
void setMinimumLengthUnit (QgsUnitTypes::RenderUnit unit)
 Sets the unit for the minimum length of callout lines. More...
 
void setOffsetFromAnchor (double distance)
 Sets the offset distance from the anchor point at which to start the line. More...
 
void setOffsetFromAnchorMapUnitScale (const QgsMapUnitScale &scale)
 Sets the map unit scale for the offset from anchor. More...
 
void setOffsetFromAnchorUnit (QgsUnitTypes::RenderUnit unit)
 Sets the unit for the offset from anchor distance. More...
 
void setOffsetFromLabel (double distance)
 Sets the offset distance from label area at which to end the line. More...
 
void setOffsetFromLabelMapUnitScale (const QgsMapUnitScale &scale)
 Sets the map unit scale for the offset from label area. More...
 
void setOffsetFromLabelUnit (QgsUnitTypes::RenderUnit unit)
 Sets the unit for the offset from label area distance. More...
 
void startRender (QgsRenderContext &context) override
 Prepares the callout for rendering on the specified render context. More...
 
void stopRender (QgsRenderContext &context) override
 Finalises the callout after a set of rendering operations on the specified render context. More...
 
- Public Member Functions inherited from QgsCallout
 QgsCallout ()
 Constructor for QgsCallout. More...
 
virtual ~QgsCallout ()=default
 
AnchorPoint anchorPoint () const
 Returns the feature's anchor point position. More...
 
QgsPropertyCollectiondataDefinedProperties ()
 Returns a reference to the callout's property collection, used for data defined overrides. More...
 
const QgsPropertyCollectiondataDefinedProperties () const
 Returns a reference to the callout's property collection, used for data defined overrides. More...
 
virtual DrawOrder drawOrder () const
 Returns the desired drawing order (stacking) to use while rendering this callout. More...
 
bool enabled () const
 Returns true if the the callout is enabled. More...
 
LabelAnchorPoint labelAnchorPoint () const
 Returns the label's anchor point position. More...
 
void render (QgsRenderContext &context, QRectF rect, const double angle, const QgsGeometry &anchor, QgsCalloutContext &calloutContext)
 Renders the callout onto the specified render context. More...
 
virtual void restoreProperties (const QDomElement &element, const QgsReadWriteContext &context)
 Restores the callout's properties from a DOM element. More...
 
virtual bool saveProperties (QDomDocument &doc, QDomElement &element, const QgsReadWriteContext &context) const
 Saves the current state of the callout to a DOM element. More...
 
void setAnchorPoint (AnchorPoint anchor)
 Sets the feature's anchor point position. More...
 
void setDataDefinedProperties (const QgsPropertyCollection &collection)
 Sets the callout's property collection, used for data defined overrides. More...
 
void setEnabled (bool enabled)
 Sets whether the callout is enabled. More...
 
void setLabelAnchorPoint (LabelAnchorPoint anchor)
 Sets the label's anchor point position. More...
 

Static Public Member Functions

static QgsCalloutcreate (const QVariantMap &properties=QVariantMap(), const QgsReadWriteContext &context=QgsReadWriteContext())
 Creates a new QgsManhattanLineCallout, using the settings serialized in the properties map (corresponding to the output from QgsManhattanLineCallout::properties() ). More...
 
- Static Public Member Functions inherited from QgsSimpleLineCallout
static QgsCalloutcreate (const QVariantMap &properties=QVariantMap(), const QgsReadWriteContext &context=QgsReadWriteContext())
 Creates a new QgsSimpleLineCallout, using the settings serialized in the properties map (corresponding to the output from QgsSimpleLineCallout::properties() ). More...
 
- Static Public Member Functions inherited from QgsCallout
static QgsCallout::AnchorPoint decodeAnchorPoint (const QString &name, bool *ok=nullptr)
 Attempts to decode a string representation of an anchor point name to the corresponding anchor point. More...
 
static QgsCallout::LabelAnchorPoint decodeLabelAnchorPoint (const QString &name, bool *ok=nullptr)
 Attempts to decode a string representation of a label anchor point name to the corresponding anchor point. More...
 
static QString encodeAnchorPoint (AnchorPoint anchor)
 Encodes an anchor point to its string representation. More...
 
static QString encodeLabelAnchorPoint (LabelAnchorPoint anchor)
 Encodes a label anchor point to its string representation. More...
 
static QgsPropertiesDefinition propertyDefinitions ()
 Returns the definitions for data defined properties available for use in callouts. More...
 

Protected Member Functions

void draw (QgsRenderContext &context, QRectF bodyBoundingBox, const double angle, const QgsGeometry &anchor, QgsCallout::QgsCalloutContext &calloutContext) override
 Performs the actual rendering of the callout implementation onto the specified render context. More...
 
- Protected Member Functions inherited from QgsCallout
QgsGeometry labelAnchorGeometry (QRectF bodyBoundingBox, const double angle, LabelAnchorPoint anchor) const
 Returns the anchor point geometry for a label with the given bounding box and anchor point mode. More...
 

Additional Inherited Members

- Public Types inherited from QgsCallout
enum  AnchorPoint { PoleOfInaccessibility = 0, PointOnExterior, PointOnSurface, Centroid }
 Feature's anchor point position. More...
 
enum  DrawOrder { OrderBelowAllLabels, OrderBelowIndividualLabels }
 Options for draw order (stacking) of callouts. More...
 
enum  LabelAnchorPoint {
  LabelPointOnExterior, LabelCentroid, LabelTopLeft, LabelTopMiddle,
  LabelTopRight, LabelMiddleLeft, LabelMiddleRight, LabelBottomLeft,
  LabelBottomMiddle, LabelBottomRight
}
 Label's anchor point position. More...
 
enum  Property {
  MinimumCalloutLength, OffsetFromAnchor, OffsetFromLabel, DrawCalloutToAllParts,
  AnchorPointPosition, LabelAnchorPointPosition
}
 Data definable properties. More...
 

Detailed Description

Draws straight (right angled) lines as callouts.

Since
QGIS 3.10

Definition at line 629 of file qgscallout.h.

Constructor & Destructor Documentation

◆ QgsManhattanLineCallout() [1/2]

QgsManhattanLineCallout::QgsManhattanLineCallout ( )

Definition at line 554 of file qgscallout.cpp.

◆ QgsManhattanLineCallout() [2/2]

QgsManhattanLineCallout::QgsManhattanLineCallout ( const QgsManhattanLineCallout other)

Copy constructor.

Definition at line 558 of file qgscallout.cpp.

Member Function Documentation

◆ clone()

QgsManhattanLineCallout * QgsManhattanLineCallout::clone ( ) const
overridevirtual

Duplicates a callout by creating a deep copy of the callout.

Caller takes ownership of the returned object.

Reimplemented from QgsSimpleLineCallout.

Definition at line 577 of file qgscallout.cpp.

◆ create()

QgsCallout * QgsManhattanLineCallout::create ( const QVariantMap &  properties = QVariantMap(),
const QgsReadWriteContext context = QgsReadWriteContext() 
)
static

Creates a new QgsManhattanLineCallout, using the settings serialized in the properties map (corresponding to the output from QgsManhattanLineCallout::properties() ).

Definition at line 565 of file qgscallout.cpp.

◆ draw()

void QgsManhattanLineCallout::draw ( QgsRenderContext context,
QRectF  bodyBoundingBox,
const double  angle,
const QgsGeometry anchor,
QgsCallout::QgsCalloutContext calloutContext 
)
overrideprotectedvirtual

Performs the actual rendering of the callout implementation onto the specified render context.

The bodyBoundingBox argument gives the desired size and position of the body of the callout (e.g. the actual label geometry). The angle argument specifies the rotation of the callout body (in degrees clockwise from horizontal). It is assumed that angle rotation specified via angle is applied around the center of rect.

The anchor argument dictates the geometry which the callout should connect to. Depending on the callout subclass and anchor geometry type, the actual shape of the rendered callout may vary. E.g. a subclass may prefer to attach to the centroid of the anchor, while another subclass may prefer to attach to the closest point on anchor instead.

Both rect and anchor are specified in painter coordinates (i.e. pixels).

The calloutContext argument is used to specify additional contextual information about how a callout is being rendered.

Reimplemented from QgsSimpleLineCallout.

Definition at line 582 of file qgscallout.cpp.

◆ operator=()

QgsManhattanLineCallout& QgsManhattanLineCallout::operator= ( const QgsManhattanLineCallout )
delete

◆ type()

QString QgsManhattanLineCallout::type ( ) const
overridevirtual

Returns a unique string representing the callout type.

Reimplemented from QgsSimpleLineCallout.

Definition at line 572 of file qgscallout.cpp.


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