class QLegend

QLegend 类用于显示图表的图例。 更多信息…

摘要

属性

• alignment属性 - 如何将图例与图表对齐

• backgroundVisible属性 - 图例背景是否可见

• borderColor - 图例的线条颜色

• color - 图例背景（画刷）颜色

• font - 图例使用的标记字体

• labelColor - 绘制标签所使用的画笔颜色

• markerShape属性

• reverseMarkers - 图例中的标记是否使用逆序

• showToolTips - 当文本被截断时是否显示工具提示

方法

• def alignment()

• def attachToChart()

• def borderColor()

• def brush()

• def color()

• def detachFromChart()

• def isAttachedToChart()

• def isBackgroundVisible()

• def isInteractive()

• def labelBrush()

• def labelColor()

• def markerShape()

• def markers()

• def pen()

• def reverseMarkers()

• def setAlignment()

• def setBackgroundVisible()

• 定义 setBorderColor()

• 定义 setBrush()

• 定义 setColor()

• 定义 setInteractive()

• 定义 setLabelBrush()

• 定义 setLabelColor()

• 定义 setMarkerShape()

• 定义 setPen()

• 定义 setReverseMarkers()

• 定义 setShowToolTips()

• 定义 showToolTips()

信号

• 定义 attachedToChartChanged()

• 定义 backgroundVisibleChanged()

• 定义 borderColorChanged()

• 定义 colorChanged()

• 定义 fontChanged()

• 定义 interactiveChanged()

• 定义 labelColorChanged()

• 定义 markerShapeChanged()

• 定义 reverseMarkersChanged()

• 定义 showToolTipsChanged()

备注

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译存在问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们

详细描述

图例是一种显示图表图例的图形对象。图例状态在系列发生更改时由 QChart 更新。默认情况下，图例附着到图表上，但可以将其分离以使其独立于图表布局。图例对象不能被创建或删除，但可以通过 QChart 类进行引用。

另请参阅

QChart

class MarkerShape

此枚举描述在渲染图例标记项时使用的形状。

常量	描述
QLegend.MarkerShapeDefault	用于标记的默认形状由 QLegend 确定。此值仅支持单个 QLegendMarker 项。
QLegend.MarkerShapeRectangle	使用矩形标记。标记大小由字体大小确定。
QLegend.MarkerShapeCircle	使用圆形标记。标记大小由字体大小确定。
QLegend.MarkerShapeRotatedRectangle	使用旋转矩形形状的标记。标记大小由字体大小确定。
QLegend.MarkerShapeTriangle	使用三角形标记。标记大小由字体大小确定。
QLegend.MarkerShapeStar	使用星星形状的标记。标记大小由字体大小确定。
QLegend.MarkerShapePentagon	使用五角形标记。标记大小由字体大小确定。
QLegend.MarkerShapeFromSeries	标记形状由系列确定。对于散点系列，图例标记看起来像散点符号，大小与点相同。对于线或样条系列，图例标记看起来像线条的小段。对于其他系列类型，显示矩形标记。如果为系列指定了 lightMarker，则显示 lightMarker 并由系列标记大小确定其大小。

另请参阅

markerShape

备注

当使用 from __feature__ import true_property 时可以直接使用属性，否则通过访问器函数。

property alignmentᅟ: Qt.AlignmentFlag 组合

此属性保持图例与图表的对齐方式。

可以是 Qt::AlignTop，Qt::AlignBottom，Qt::AlignLeft，Qt::AlignRight。如果设置了多个标志，则结果未定义。

访问函数

• alignment()

• setAlignment()

property backgroundVisibleᅟ: bool

此属性表示图例背景是否可见。

访问函数

• isBackgroundVisible()

• setBackgroundVisible()

• 信号 backgroundVisibleChanged()

属性 borderColor: QColor

该属性保存图例中线的颜色。

访问函数

• borderColor()

• setBorderColor()

• 信号 borderColorChanged()

属性 color: QColor

该属性保存图例的背景（画刷）颜色。

如果您更改图例的颜色，图例画刷的样式设置为Qt::SolidPattern。

访问函数

• color()

• setColor()

• 信号 colorChanged()

属性 font: QFont

该属性保存用于图例标记的字形。

访问函数

• 信号 fontChanged()

属性 labelColor: QColor

该属性保存用于绘制标签的画刷颜色。

访问函数

• labelColor()

• setLabelColor()

• 信号 labelColorChanged()

属性 markerShape: QLegend.MarkerShape

图例标记的默认形状。默认值是MarkerShapeRectangle。

访问函数

• markerShape()

• setMarkerShape()

• 信号 markerShapeChanged()

属性 reverseMarkers: bool

该属性保存是否在图例中反向顺序使用标记。

默认情况下，该属性为false。

访问函数

• reverseMarkers()

• setReverseMarkers()

• 信号 reverseMarkersChanged()

属性showToolTipsᅟ: bool

此属性表示是否在文本被截断时显示工具提示。

默认情况下，该属性为false。

访问函数

• showToolTips()

• setShowToolTips()

• 信号 showToolTipsChanged()

alignment()

返回类型：

AlignmentFlag 的组合

另请参阅

setAlignment()

alignmentᅟ 的获取器。

attachToChart()

将图例附加到图表。图表可能调整图例的布局。

attachedToChartChanged(attachedToChart)

参数：

attachedToChart - bool

当图例被 附加 到或从图表中移除时发出此信号。

backgroundVisibleChanged(visible)

参数：

visible - bool

当图例背景的可见性变为 visible 时发出此信号。

backgroundVisibleᅟ 的通知信号。

borderColor()

返回类型：

QColor

另请参阅

setBorderColor()

borderColorᅟ 的获取器。

borderColorChanged(color)

参数：

color - QColor

当图例背景的边框颜色变为 color 时发出此信号。

borderColorᅟ 的通知信号。

brush()

返回类型：

QBrush

返回图例使用的画笔。

另请参阅

setBrush()

color()

返回类型：

QColor

另请参阅

setColor()

属性 color 的获取器。

colorChanged(color)

参数：

color - QColor

当图例背景色变为 color 时，该信号被发出。

color 属性的通知信号。

detachFromChart()

从图表中移除图例。图表将不再调整图例布局。

fontChanged(font)

参数：

font – QFont

当图例标记的字体变为 font 时，该信号被发出。

font 属性的通知信号。

interactiveChanged(interactive)

参数：

interactive – bool

isAttachedToChart()

返回类型：

bool

如果图例附加到图表上，则返回 true。

isBackgroundVisible()

返回类型：

bool

返回图例背景的可见性。

backgroundVisible 属性的获取器。

isInteractive()

返回类型：

bool

返回当图例被移除时，是否可以使用鼠标拖动或调整大小。

另请参阅

setInteractive()

labelBrush()

返回类型：

QBrush

返回用于绘制标签的画刷。

另请参阅

setLabelBrush()

labelColor()

返回类型：

QColor

另请参阅

setLabelColor()

labelColor 属性的获取器。

labelColorChanged(color)

参数：

color - QColor

当用于绘制图例标签的画刷颜色变为 color 时，该信号被发出。

属性 labelColor 的通知信号。

markerShape()

返回类型：

MarkerShape

另请参阅

setMarkerShape()

属性 markerShape 的 getter。

markerShapeChanged(shape)

参数：

shape – MarkerShape

属性 markerShape 的通知信号。

markers()

返回类型：

一个 QLegendMarker 列表

pen()

返回类型：

QPen

返回图例使用的画笔。

另请参阅

setPen()

reverseMarkers()

返回类型：

bool

另请参阅

setReverseMarkers()

属性 reverseMarkers 的 getter。

reverseMarkersChanged(reverseMarkers)

参数：

reverseMarkers – bool

当图例中标记的逆序使用被改为 reverseMarkers 时发出此信号。

属性 reverseMarkers 的通知信号。

setAlignment(alignment)

参数：

alignment – AlignmentFlag 组合

另请参阅

alignment()

属性 alignment 的 setter。

setBackgroundVisible([visible=true])

参数：

visible - bool

将图例背景的可见性设置为 visible。

另请参阅

isBackgroundVisible()

属性 backgroundVisible 的 setter。

setBorderColor(color)

参数：

color - QColor

另请参阅

borderColor()

设置 borderColor属性 的属性。

setBrush(brush)

参数：

brush – QBrush

设置用于绘制图例背景的 brush。

另请参阅

brush()

setColor(color)

参数：

color - QColor

另请参阅

color()

设置 color属性 的属性。

setInteractive(interactive)

参数：

interactive – bool

当 interactive 为 true 且图例已分离时，图例可以通过类似窗口的方式通过鼠标移动和调整大小。

拖动图例将其从边缘移出时，图例将自动连接到图表的边缘。双击已连接的图例可将其分离。默认为 false。

另请参阅

isInteractive()

setLabelBrush(brush)

参数：

brush – QBrush

设置用于绘制图例标签的刷子为 brush。

另请参阅

labelBrush()

setLabelColor(color)

参数：

color - QColor

另请参阅

labelColor()

设置 labelColor属性 的属性。

setMarkerShape(shape)

参数：

shape – MarkerShape

另请参阅

markerShape()

设置 markerShape属性 的属性。

setPen(pen)

参数：

pen – QPen

设置用于绘制图例边框的 pen。

另请参阅

pen()

setReverseMarkers([reverseMarkers=true])

参数：

reverseMarkers – bool

另请参阅

reverseMarkers()

属性 reverseMarkers 的设置器。

setShowToolTips(show)

参数：

show – bool

当 show 为 true 时，如果图例标签本身显示为省略，则当鼠标悬停在标签上时将显示工具提示。默认为 false。

另请参阅

showToolTips()

属性 showToolTips 的设置器。

showToolTips()

返回类型：

bool

返回当标签被省略时是否显示图例标签的工具提示。

另请参阅

setShowToolTips()

属性 showToolTips 的获取器。

showToolTipsChanged(showToolTips)

参数：

showToolTips – bool

当工具提示的可见性更改为 showToolTips 时，发出此信号。

属性 showToolTips 的通知信号。