LightningChart Python 的 GaugeChart 如何添加图例项？

2026-11-06数据小陈

结论

chart.legend.set_options() 用于设置图例的显示方式、位置和标题等选项。要让 GaugeChart 显示自定义条目，还要创建额外图例，并调用 legend.add(None, options) 添加条目。None 表示该条目不关联任何图表组件，适合用来展示“Temperature Sensor”这类说明。

问题中的 GaugeChart 只有一个仪表值。仅开启图例并设置标题，不会自动生成“Temperature Sensor”条目。LightningChart Python 的 Gauge Chart 文档链接到通用 Legend 文档，后者提供了为 Gauge Chart 添加自定义图例项的示例。Gauge Chart 文档 · Legend 文档

添加自定义图例项

可以在示例中创建额外图例，再用 legend.add(None, {...}) 设置条目的文字和样式：

import lightningchart as lc

chart = lc.GaugeChart(theme=lc.Themes.Dark, title="Gauge Chart")

legend = chart.add_legend(title="Legend", position="TopRight")
legend.add(
    None,
    {
        "show": True,
        "button_shape": "Circle",
        "button_size": 20,
        "button_fill_style": "#CB5B15",
        "text": "Temperature Sensor",
    },
)

chart.set_interval(0, 100)
chart.set_value(64.78)

chart.open()

button_shape 和 button_fill_style 分别设置图标形状和填充颜色，text 设置图例文字。需要边框时，可以添加 button_stroke_style，例如 {"thickness": 2, "color": "#003300"}。

注意事项

legend.add(None, options) 添加的是独立图例条目，不会自动关联或控制仪表盘上的 Gauge。若要让图例表示某个颜色区间或状态，需要自行确保图例说明与 Gauge 配置一致。
可以在 chart.add_legend() 中设置图例位置和标题，无需通过 chart.legend.set_options() 创建条目。
示例中的 button_shape、颜色和尺寸用于设置样式，可按界面需要调整。