当前位置：首页 > news >正文

Qt扫盲-QPen 理论使用总结

news 来源：原创 2025/5/1 14:02:35

QPen 理论使用总结

一、概述
二、Pen Style 画笔风格
三、Cap Style 帽风格
四、Join Style 连接处样式

一、概述

QPen 是Qt绘图控件里面的一个重要的组件，和QColor 一样也是类似的一个属性类。这个类就是描述一个画笔具有的属性。

一个画笔 Pen 有style()， width()， brush()， capStyle()和 joinStyle()。
笔的 style() [样式] 定义了线条的类型。brush() [笔刷] 用于填充 Pen 生成的笔画。使用QBrush类来指定填充样式。capStyle() [笔帽样式] 决定了可以使用QPainter绘制的线尾帽，而 joinStyle() [连接样式] 描述了如何绘制两条线之间的连接。笔的宽度可以以整数 ( width())和浮点(widthF())精度指定。线宽为0表示化妆笔。这意味着笔的宽度总是画一个像素宽，独立于 QPainter 的变换设置。

我们可以使用相应的 setStyle()， setWidth()， setBrush()， setCapStyle() 和 setJoinStyle() 函数可以很容易地修改各种设置(注意，当改变笔的属性时，painter的笔必须重置)。

例如:

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

它等价于

  QPainter painter(this);
  QPen pen;  // creates a default pen

  pen.setStyle(Qt::DashDotLine);
  pen.setWidth(3);
  pen.setBrush(Qt::green);
  pen.setCapStyle(Qt::RoundCap);
  pen.setJoinStyle(Qt::RoundJoin);

  painter.setPen(pen);

默认笔是一个纯黑色的笔刷，宽度为1，方帽样式(Qt::SquareCap)和斜角连接样式(Qt::BevelJoin)。

此外，QPen还提供了color()和setColor()方便函数，分别用于提取和设置Pen 笔刷的颜色。笔也可以进行比较和写入 stream。

二、Pen Style 画笔风格

Qt提供了几个由Qt::PenStyle枚举表示的内置样式:

Qt::SolidLine	Qt::SolidLine	Qt::DotLine

Qt: DashDotLine	Qt: DashDotDotLine	Qt: CustomDashLine

只需使用setStyle()函数将Pen 样式转换为内置样式中的任何一种，除了Qt::CustomDashLine样式，我们将很快回到它。将样式设置为Qt::NoPen告诉painter不绘制线条或轮廓。Pen 的默认样式是Qt::SolidLine。

自Qt 4.1以来，也可以使用 setDashPattern() 函数指定自定义破折号模式，该函数隐式地将笔的样式转换为Qt::CustomDashLine。模式参数QVector必须指定为偶数个qreal条目，其中条目1,3,5…是破折号和2,4,6…是空格。例如，上面显示的自定义模式是使用以下代码创建的:

  QPen pen;
  QVector<qreal> dashes;
  qreal space = 4;

  dashes << 1 << space << 3 << space << 9 << space
             << 27 << space << 9 << space;

  pen.setDashPattern(dashes);