Back to Qt.io
Contact Us Blog Download Qt
本页内容

QLegendMarker Class

QLegendMarker 类是一个抽象对象，可用于访问图例中的标记。更多内容...

Header: #include <QLegendMarker>
Inherits: QObject
Inherited By:

QAreaLegendMarker, QBarLegendMarker, QBoxPlotLegendMarker, QCandlestickLegendMarker, QPieLegendMarker, and QXYLegendMarker

Status: Deprecated

该类已弃用。我们强烈建议不要在新的代码中使用它。

公共类型

enum LegendMarkerType { LegendMarkerTypeArea, LegendMarkerTypeBar, LegendMarkerTypePie, LegendMarkerTypeXY, LegendMarkerTypeBoxPlot, LegendMarkerTypeCandlestick }

属性

公共函数

virtual ~QLegendMarker()
QBrush brush() const
QFont font() const
bool isVisible() const
QString label() const
QBrush labelBrush() const
QPen pen() const
virtual QAbstractSeries *series() = 0
void setBrush(const QBrush &brush)
void setFont(const QFont &font)
void setLabel(const QString &label)
void setLabelBrush(const QBrush &brush)
void setPen(const QPen &pen)
void setShape(QLegend::MarkerShape shape)
void setVisible(bool visible)
QLegend::MarkerShape shape() const
virtual QLegendMarker::LegendMarkerType type() = 0

信号

void brushChanged()
void clicked()
void fontChanged()
void hovered(bool status)
void labelBrushChanged()
void labelChanged()
void penChanged()
void shapeChanged()
void visibleChanged()

详细说明

图例标记由图标和标签组成。图标的颜色与绘制数据系列时使用的颜色相对应，标签则显示数据系列的名称（对于饼图系列，则显示扇区的标签；对于条形图系列，则显示条形集的标签）。每个图例标记始终与一个数据系列、扇区或条形集相关联。

百分比条形图，下方图例按颜色标注了五组条形

另请参阅 QLegend 。

成员类型文档

enum QLegendMarker::LegendMarkerType

图例标记对象的类型。

常量值描述
QLegendMarker::LegendMarkerTypeArea0区域系列的图例标记。
QLegendMarker::LegendMarkerTypeBar1条形集的图例标记。
QLegendMarker::LegendMarkerTypePie2用于扇形图的图例标记。
QLegendMarker::LegendMarkerTypeXY3用于折线、样条曲线或散点系列的图例标记。
QLegendMarker::LegendMarkerTypeBoxPlot4箱线图系列的图例标记。
QLegendMarker::LegendMarkerTypeCandlestick5K线系列的图例标记。

属性文档

brush : QBrush

该属性存储用于填充图标的画笔。

访问函数：

QBrush brush() const
void setBrush(const QBrush &brush)

通知器信号：

void brushChanged()

font : QFont

该属性存储标签的字体。

访问函数：

QFont font() const
void setFont(const QFont &font)

通知信号：

void fontChanged()

label : QString

该属性存储图例标记在图例中显示的文本。

访问函数：

QString label() const
void setLabel(const QString &label)

通知信号：

void labelChanged()

labelBrush : QBrush

该属性存储标签的画笔。

访问函数：

QBrush labelBrush() const
void setLabelBrush(const QBrush &brush)

通知信号：

void labelBrushChanged()

pen : QPen

该属性保存了用于绘制图标轮廓的画笔。

访问函数：

QPen pen() const
void setPen(const QPen &pen)

通知器信号：

void penChanged()

shape : QLegend::MarkerShape

图例标记的形状。默认值为QLegend::MarkerShapeDefault ，表示该形状由QLegend::markerShape 属性决定。

访问函数：

QLegend::MarkerShape shape() const
void setShape(QLegend::MarkerShape shape)

通知信号：

void shapeChanged()

visible : bool

此属性控制图例标记的可见性。

可见性同时影响图例标记的标签和图标。

访问函数：

bool isVisible() const
void setVisible(bool visible)

通知信号：

void visibleChanged()

成员函数文档

[virtual noexcept] QLegendMarker::~QLegendMarker()

删除图例标记。

QBrush QLegendMarker::brush() const

返回用于填充图标的画笔。

注意： 这是 brush 属性的获取 函数。

另请参阅 setBrush()。

[signal] void QLegendMarker::brushChanged()

当图例标记的画笔发生变化时，会触发此信号。

注意： 这是属性brush的通知 信号。

[signal] void QLegendMarker::clicked()

点击图例标记时会发出此信号。

QFont QLegendMarker::font() const

返回标签的字体。

注意： 这是 font 属性的获取器 函数。

另请参阅 ` setFont()`。

[signal] void QLegendMarker::fontChanged()

当图例标记的（标签）字体发生变化时，会发出此信号。

注意： 这是属性font的通知 信号。

[signal] void QLegendMarker::hovered(bool status)

当鼠标悬停在图例标记上时，会发出此信号。当鼠标移到标记上方时，status 会变为true ；当鼠标再次移开时，它会变为false 。

bool QLegendMarker::isVisible() const

返回标记的可见性。

注意： 这是属性visible 的获取器 函数。

QString QLegendMarker::label() const

返回标记的标签。

注意： 这是 label 属性的获取 函数。

另请参阅 setLabel()。

QBrush QLegendMarker::labelBrush() const

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

注意： 这是 labelBrush 属性的获取 函数。

另请参阅 ` setLabelBrush()`。

[signal] void QLegendMarker::labelBrushChanged()

当图例标记的标签画笔发生变化时，会发出此信号。

注意： 这是属性labelBrush 的Notifier 信号。

[signal] void QLegendMarker::labelChanged()

当图例标记的标签发生变化时，会发出此信号。

注意： 这是属性label的通知器 信号。

QPen QLegendMarker::pen() const

返回用于绘制图标轮廓的画笔。

注意： 这是属性 pen 的获取 函数。

另请参阅 setPen()。

[signal] void QLegendMarker::penChanged()

当图例标记的笔触发生变化时，会发出此信号。

注意： 这是属性pen的通知器 信号。

[pure virtual] QAbstractSeries *QLegendMarker::series()

返回指向与该图例标记相关的数据系列的指针。图例标记总是与某个数据系列相关联。

void QLegendMarker::setBrush(const QBrush &brush)

将用于填充图标的画笔设置为brush 。

注意：更改系列的 颜色也会改变图标的颜色。

注意： 这是属性 `brush`的设置 函数。

另请参阅 brush()。

void QLegendMarker::setFont(const QFont &font)

将标签的字体设置为font 。

注意： 这是属性font 的设置 函数。

另请参阅 font()。

void QLegendMarker::setLabel(const QString &label)

将标记的标签设置为label 。

注意：更改 系列名称也会更改其标记的标签。

注意： 这是属性label 的设置 函数。

另请参阅 label()。

void QLegendMarker::setLabelBrush(const QBrush &brush)

将用于绘制标签的画笔设置为brush 。

注意： 这是属性 `labelBrush`的设置 函数。

另请参阅 labelBrush()。

void QLegendMarker::setPen(const QPen &pen)

将用于绘制图标轮廓的pen 设置为pen 。

注意： 这是属性pen 的设置 函数。

另请参阅 pen()。

void QLegendMarker::setVisible(bool visible)

将标记的可见性设置为visible 。

注意： 这是属性visible 的设置 函数。

另请参阅 isVisible()。

[pure virtual] QLegendMarker::LegendMarkerType QLegendMarker::type()

返回相关系列、饼图扇区或柱状图集的图例标记类型。

另请参阅 LegendMarkerType 。

[signal] void QLegendMarker::visibleChanged()

当图例标记的可见性发生变化时，会发出此信号。

注意： 这是属性visible的通知器 信号。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.