Class: QgsDiagramLayerSettings¶
-
class
qgis.core.
QgsDiagramLayerSettings
¶ Bases:
sip.wrapper
Constructor for QgsDiagramLayerSettings.
QgsDiagramLayerSettings(rh: QgsDiagramLayerSettings) Copy constructor
Stores the settings for rendering of all diagrams for a layer.
QgsDiagramSettings stores the settings related to rendering the individual diagrams themselves, while QgsDiagramLayerSettings stores settings which control how ALL diagrams within a layer are rendered.
Enums
Methods
Returns the coordinate transform associated with the layer, or an invalid transform if no transformation is required.
Returns a reference to the diagram’s property collection, used for data defined overrides.
Returns the distance between the diagram and the feature (in mm).
Returns whether the feature associated with a diagram acts as an obstacle for other labels or diagrams.
Returns the diagram placement flags.
Returns the diagram placement.
Prepares the diagrams for a specified expression context.
Returns the diagram priority.
Returns the diagram property definitions.
Reads the diagram settings from a DOM element.
Returns the set of any fields referenced by the layer’s diagrams.
Returns the diagram renderer associated with the layer.
Sets the coordinate transform associated with the layer.
Sets the diagram’s property collection, used for data defined overrides.
Sets the distance between the diagram and the feature.
Sets whether the feature associated with a diagram acts as an obstacle for other labels or diagrams.
Sets the the diagram placement flags.
Sets the diagram placement.
Sets the diagram priority.
Sets the diagram renderer associated with the layer.
Sets whether the layer should show all diagrams, including overlapping diagrams
Sets the diagram z-index.
Returns whether the layer should show all diagrams, including overlapping diagrams
Writes the diagram settings to a DOM element.
Returns the diagram z-index.
Signals
Attributes
-
AboveLine
= 2¶
-
AlwaysShow
= 10¶
-
AroundPoint
= 0¶
-
BackgroundColor
= 0¶
-
BelowLine
= 4¶
-
Curved
= 3¶
-
Distance
= 5¶
-
Free
= 5¶
-
Horizontal
= 4¶
-
IsObstacle
= 8¶
-
Line
= 2¶
-
class
LinePlacementFlag
¶ Bases:
int
-
class
LinePlacementFlags
¶ Bases:
sip.wrapper
QgsDiagramLayerSettings.LinePlacementFlags(Union[QgsDiagramLayerSettings.LinePlacementFlags, QgsDiagramLayerSettings.LinePlacementFlag]) QgsDiagramLayerSettings.LinePlacementFlags(QgsDiagramLayerSettings.LinePlacementFlags)
-
MapOrientation
= 16¶
-
OnLine
= 1¶
-
OverPoint
= 1¶
-
class
Placement
¶ Bases:
int
-
PositionX
= 3¶
-
PositionY
= 4¶
-
Priority
= 6¶
-
class
Property
¶ Bases:
int
-
Show
= 9¶
-
StartAngle
= 11¶
-
StrokeColor
= 1¶
-
StrokeWidth
= 2¶
-
ZIndex
= 7¶
-
coordinateTransform
(self) → QgsCoordinateTransform¶ Returns the coordinate transform associated with the layer, or an invalid transform if no transformation is required.
See also
New in version 2.16.
-
dataDefinedProperties
(self) → QgsPropertyCollection¶ Returns a reference to the diagram’s property collection, used for data defined overrides.
See also
New in version 3.0.
-
distance
(self) → float¶ Returns the distance between the diagram and the feature (in mm).
See also
New in version 2.16.
-
isObstacle
(self) → bool¶ Returns whether the feature associated with a diagram acts as an obstacle for other labels or diagrams.
See also
New in version 2.16.
-
linePlacementFlags
(self) → QgsDiagramLayerSettings.LinePlacementFlags¶ Returns the diagram placement flags. These are only used if the diagram placement is set to a line type.
See also
New in version 2.16.
-
placement
(self) → QgsDiagramLayerSettings.Placement¶ Returns the diagram placement.
See also
New in version 2.16.
-
prepare
(self, context: QgsExpressionContext = QgsExpressionContext()) → bool¶ Prepares the diagrams for a specified expression context. Calling prepare before rendering multiple diagrams allows precalculation of expensive setup tasks such as parsing expressions. Returns
True
if preparation was successful.New in version 3.0.
-
priority
(self) → int¶ Returns the diagram priority.
- Returns
diagram priority, where 0 = low and 10 = high
Note
placement priority is shared with labeling, so diagrams with a high priority may displace labels and vice-versa
See also
New in version 2.16.
-
propertyDefinitions
() → Dict[int, QgsPropertyDefinition]¶ Returns the diagram property definitions.
New in version 3.0.
-
readXml
(self, elem: QDomElement)¶ Reads the diagram settings from a DOM element.
See also
-
referencedFields
(self, context: QgsExpressionContext = QgsExpressionContext()) → Set[str]¶ Returns the set of any fields referenced by the layer’s diagrams.
- Parameters
context – expression context the diagrams will be drawn using
New in version 2.16.
-
renderer
(self) → QgsDiagramRenderer¶ Returns the diagram renderer associated with the layer.
See also
New in version 2.16.
-
setCoordinateTransform
(self, transform: QgsCoordinateTransform)¶ Sets the coordinate transform associated with the layer.
- Parameters
transform – coordinate transform. Ownership is transferred to the object.
See also
New in version 2.16.
-
setDataDefinedProperties
(self, collection: QgsPropertyCollection)¶ Sets the diagram’s property collection, used for data defined overrides.
- Parameters
collection – property collection. Existing properties will be replaced.
See also
See also
Property
New in version 3.0.
-
setDistance
(self, distance: float)¶ Sets the distance between the diagram and the feature.
- Parameters
distance – distance in mm
See also
New in version 2.16.
-
setIsObstacle
(self, isObstacle: bool)¶ Sets whether the feature associated with a diagram acts as an obstacle for other labels or diagrams.
- Parameters
isObstacle – set to
True
for feature to act as obstacle
See also
New in version 2.16.
-
setLinePlacementFlags
(self, flags: Union[QgsDiagramLayerSettings.LinePlacementFlags, QgsDiagramLayerSettings.LinePlacementFlag])¶ Sets the the diagram placement flags. These are only used if the diagram placement is set to a line type.
- Parameters
flags – placement value
See also
New in version 2.16.
-
setPlacement
(self, value: QgsDiagramLayerSettings.Placement)¶ Sets the diagram placement.
- Parameters
value – placement value
See also
New in version 2.16.
-
setPriority
(self, value: int)¶ Sets the diagram priority.
- Parameters
value – priority, where 0 = low and 10 = high
See also
New in version 2.16.
-
setRenderer
(self, diagramRenderer: QgsDiagramRenderer)¶ Sets the diagram renderer associated with the layer.
- Parameters
diagramRenderer – diagram renderer. Ownership is transferred to the object.
See also
New in version 2.16.
-
setShowAllDiagrams
(self, showAllDiagrams: bool)¶ Sets whether the layer should show all diagrams, including overlapping diagrams
- Parameters
showAllDiagrams – set to
True
to show all diagrams
See also
New in version 2.16.
-
setZIndex
(self, index: float)¶ Sets the diagram z-index. Diagrams (or labels) with a higher z-index are drawn over diagrams with a lower z-index.
- Parameters
index – diagram z-index
See also
New in version 2.16.
-
showAllDiagrams
(self) → bool¶ Returns whether the layer should show all diagrams, including overlapping diagrams
See also
New in version 2.16.
-
writeXml
(self, layerElem: QDomElement, doc: QDomDocument)¶ Writes the diagram settings to a DOM element.
See also
-
zIndex
(self) → float¶ Returns the diagram z-index. Diagrams (or labels) with a higher z-index are drawn over diagrams with a lower z-index.
Note
z-index ordering is shared with labeling, so diagrams with a high z-index may be drawn over labels with a low z-index and vice-versa
See also
New in version 2.16.
-