文本标签 - QwtPlotTextLabel¶

QwtPlotTextLabel 用于在绘图上显示文本标签，与 QwtPlotMarker 的标签不同，它使用画布几何坐标而非绘图数据坐标定位，适合显示固定的说明文字或标题。

主要功能特性¶

特性

✅ 画布坐标定位：使用相对画布位置，不随坐标轴变换
✅ 文本样式支持：支持字体、颜色、边距等样式配置
✅ 对齐控制：可设置文本相对于定位点的对齐方式
✅ 背景设置：可设置文本背景颜色或边框

基本概念¶

坐标定位方式¶

与 QwtPlotMarker 的区别：

类	坐标类型	说明
`QwtPlotMarker`	数据坐标	随坐标轴缩放变换
`QwtPlotTextLabel`	画布坐标	固定在画布位置，不变换

定位示意¶

┌────────────────────────────────────┐
│                                    │
│  标签文本            ← 固定在右上角│
│                          (相对位置)│
│                                    │
│            ┌─────────┐             │
│            │ 绘图数据 │             │
│            └─────────┘             │
│                                    │
└────────────────────────────────────┘

使用方法¶

1. 创建文本标签¶

#include <QwtPlot>
#include <QwtPlotTextLabel>
#include <QwtText>

QwtPlot* plot = new QwtPlot();

// 创建文本标签
QwtPlotTextLabel* label = new QwtPlotTextLabel();

// 设置文本内容
QwtText text("图表说明");
text.setFont(QFont("Arial", 12, QFont::Bold));
text.setColor(Qt::black);
label->setText(text);

// 设置位置（相对画布坐标）
label->setPos(0.9, 0.1);  // 右上角（90%宽度, 10%高度）

// 设置对齐方式
label->setAlignment(Qt::AlignRight | Qt::AlignTop);

label->attach(plot);
plot->replot();

2. 文本样式配置¶

QwtText text;

// 设置字体
text.setFont(QFont("Helvetica", 10));

// 设置颜色
text.setColor(Qt::darkBlue);

// 设置背景色
text.setBackgroundBrush(QBrush(QColor(255, 255, 200)));

// 设置边框
text.setBorderPen(QPen(Qt::gray, 1));

// 设置边距
text.setMargins(5);  // 文本与边框的间距

label->setText(text);

3. 位置和对齐¶

// 设置位置（归一化坐标，范围[0,1]）
label->setPos(0.5, 0.5);  // 画布中心

// 设置对齐（相对于定位点）
label->setAlignment(Qt::AlignCenter);

// 其他对齐选项：
// Qt::AlignLeft | Qt::AlignTop    - 左上
// Qt::AlignRight | Qt::AlignBottom - 右下
// Qt::AlignHCenter | Qt::AlignVCenter - 中心

4. 旋转文本¶

// 设置文本旋转角度
label->setRotation(45.0);  // 45度旋转

核心方法总结¶

方法	说明
`setText()`	设置文本内容
`setPos()`	设置位置（归一化坐标）
`setAlignment()`	设置对齐方式
`setRotation()`	设置旋转角度
`setGeometry()`	设置几何区域

应用场景

图表标题或说明文字
固定位置标注
单位说明
版本信息显示