从零开始学Qt（57）：一文读懂QPen的使用（画线奇兵）

从零开始学Qt（57）：一文读懂QPen的使用

QPen用于绘图时对线条进行设置，主要包括线宽、颜色、线型等，下面是QPen类的主要接口函数。通常一个设置函数都有一个对应的读取函数，例如setColor()用于设置画笔颜色，对应的读取画笔颜色的函数为color()，这里仅列出设置函数（省略了函数参数中的const关键字）。

void setColor(QColor &color)：设置画笔颜色，即线条颜色
void setWidth(int width)：设置线条宽度
void setStyle(Qt::PenStyle style)：设置线条样式，参数为QPenStyle枚举类型
void setCapStyle(Qt::PenCapStyle style)：设置线条端点样式，参数为QPenCapStyle枚举类型
void setJoinStyle (Qt::PenJoinStyle style)：设置连接样式，参数为QPenJoinStyle枚举类型

创建QPen的代码如下：

QPainter painter(this); QPen pen(Qt::green, 3, Qt::DashDotLine, Qt::RoundCap, Qt::RoundJoin); painter.setPen(pen);

上述代码等同于

QPainter painter(this); QPen pen; pen.setStyle(Qt::DashDotLine); pen.setWidth(3); pen.setBrush(Qt::green); pen.setCapStyle(Qt::RoundCap); pen.setJoinStyle(Qt::RoundJoin); painter.setPen(pen);

线条颜色和宽度的设置无需多说，QPen影响线条特性的另外3个主要属性是线条样式(style)、端点样式（capStyle)和连接样式（joinStyle)。

线条样式

setStyle(Qt::PenStyle style)函数用于设置线条样式，参数是一个枚举类型Qt::PenStyle的常量，几种典型的线条样式的绘图效果如下图所示。QtPenStyle类型还有一个常量Qt::NoPen表示不绘制线条。

各种样式的线条

Qt::NoPen：没有线条
Qt::SolidLine：一条普通的线
Qt::DashLine：由几个像素分隔的划线
Qt::DotLine：由几个像素分隔的点线
Qt::DashDotLine：交替的点划线
Qt::DashDotDotLine：一段划，两个点，一段划，两个点。

除了几种基本的线条样式外，用户还可以自定义线条样式（Qt::CustomDashLine），自定义线条样式时需要用到setDashOffset()和setDashPattem()函数。上图中自定义线条的代码为，

QPen pen; QVector<qreal> dashes; qreal space = 4; dashes << 1 << space << 3 << space << 9 << space << 27 << space << 9 << space; pen.setDashPattern(dashes);线条端点样式

setCapStyle(Qt::PenCapStyle style)函数用于设置线条端点样式，参数是一个枚举类型 QPenCapStyle的常量，该枚举类型的3种取值及其绘图效果如下图所示。