QPen Class

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);

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

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

pen.setDashPattern(dashes);

成员函数文档

QPen::QPen()

创建一个默认的黑色实线笔，宽度为 1。

QPen::QPen(Qt::PenStyle style)

创建一支宽度为 1、颜色为给定值的黑色笔：style 。

另请参阅 setStyle()。

QPen::QPen(const QColor &color)

绘制一条宽度为 1、颜色为给定值color 的实线。

另请参阅 setBrush() 和setColor()。

QPen::QPen(const QBrush &brush, qreal width, Qt::PenStyle style = Qt::SolidLine, Qt::PenCapStyle cap = Qt::SquareCap, Qt::PenJoinStyle join = Qt::BevelJoin)

创建一支具有指定brush 、width 、penstyle 、cap 样式以及join 样式的笔。

另请参阅 setBrush()、setWidth()、setStyle()、setCapStyle() 和setJoinStyle()。

[noexcept] QPen::QPen(const QPen &pen)

创建一个笔，该笔是给定pen 的副本。

[constexpr noexcept default] QPen::QPen(QPen &&pen)

创建一个从给定的pen 中移动过来的笔。

该“已移动”的笔对象仅可被赋值、复制或销毁。任何其他操作（在赋值之前）都会导致未定义行为。

[noexcept] QPen::~QPen()

把笔弄坏了。

QBrush QPen::brush() const

返回用于填充此笔生成的笔画的画笔。

另请参阅 setBrush()。

Qt::PenCapStyle QPen::capStyle() const

返回笔帽的样式。

另请参阅 setCapStyle() 和Cap Style 。

QColor QPen::color() const

返回此画笔的笔刷颜色。

另请参阅 brush() 和setColor()。

qreal QPen::dashOffset() const

返回笔的破折号偏移量。

另请参阅 setDashOffset()。

QList<qreal> QPen::dashPattern() const

返回此笔的破折号样式。

另请参阅 setDashPattern()、style()，以及isSolid()。

bool QPen::isCosmetic() const

如果画笔是装饰性画笔，则返回true ；否则返回false 。

装饰性画笔用于绘制宽度恒定的笔画，无论对其所配合使用的QPainter 应用何种变换，笔画宽度均保持不变。使用装饰性画笔绘制形状可确保其轮廓在不同的缩放因子下保持相同的粗细。

默认情况下，宽度为零的画笔是装饰性的。

另请参阅 setCosmetic() 和widthF()。

bool QPen::isSolid() const

如果画笔具有实心填充，则返回true ；否则返回 false。

另请参阅 style() 和dashPattern()。

Qt::PenJoinStyle QPen::joinStyle() const

返回笔触的连接样式。

另请参阅 setJoinStyle() 和Join Style 。

qreal QPen::miterLimit() const

返回笔的斜切限制。只有当接合样式设置为Qt::MiterJoin 时，斜切限制才起作用。

另请参阅 setMiterLimit() 和Join Style 。

void QPen::setBrush(const QBrush &brush)

将用于填充此画笔生成的笔画的画笔设置为指定的brush 。

另请参阅 brush() 和setColor()。

void QPen::setCapStyle(Qt::PenCapStyle style)

将笔帽样式设置为指定的style 。默认值为Qt::SquareCap 。

另请参阅 capStyle() 和Cap Style 。

void QPen::setColor(const QColor &color)

将此画笔的颜色设置为指定的color 。

另请参阅 setBrush() 和color()。

void QPen::setCosmetic(bool cosmetic)

根据cosmetic 的值，将此笔设置为“外观”或“非外观”模式。

另请参阅 isCosmetic()。

void QPen::setDashOffset(qreal offset)

将此画笔的虚线偏移量（即虚线图案的起始点）设置为指定的offset 值。偏移量的测量单位与指定虚线图案时所用的单位相同。

另请参阅 dashOffset()。

void QPen::setDashPattern(const QList<qreal> &pattern)

将此画笔的破折号图案设置为给定的pattern 。这会隐式地将画笔样式转换为Qt::CustomDashLine 。

该图案必须指定为偶数个正数条目，其中第 1、3、5… 个条目为短线，第 2、4、6… 个条目为空格。例如：

连线图案以画笔宽度的单位指定；例如，在宽度为 10 的情况下，长度为 5 的连线长度为 50 像素。请注意，宽度为零的画笔等同于宽度为 1 像素的装饰性画笔。

每个短划线还受端点样式的影响，因此，如果将长度为 1 的短划线设置为方形端点，则该短划线将向每个方向延伸 0.5 像素，导致总宽度为 2。

请注意，默认端点样式为Qt::SquareCap ，这意味着方形线端会覆盖端点，并向外延伸半个线宽。

另请参阅 setStyle()、dashPattern()、setCapStyle() 和setCosmetic()。

void QPen::setJoinStyle(Qt::PenJoinStyle style)

将笔的连接样式设置为指定的style 。默认值为Qt::BevelJoin 。

另请参阅 joinStyle() 和Join Style 。

void QPen::setMiterLimit(qreal limit)

将此笔的斜接限制设置为指定的limit 。

斜接限制描述了斜接接头可以从接合点延伸多远。这用于减少在两条线接近平行时的线段接合处产生的伪影。

此值仅在笔触样式设置为Qt::MiterJoin 时生效。该值以笔触宽度为单位指定，例如，在宽度为10的情况下，5的斜接限制长度为50像素。默认斜接限制为2，即笔触宽度的两倍（以像素为单位）。

另请参阅 miterLimit()、setJoinStyle() 和Join Style 。

void QPen::setStyle(Qt::PenStyle style)

将笔触样式设置为给定的style 。

有关可用样式的列表，请参阅Qt::PenStyle 文档。自Qt 4.1起，还可以使用setDashPattern()函数指定自定义虚线图案，该函数会隐式地将笔的样式转换为Qt::CustomDashLine 。

另请参阅 style() 和Pen Style 。

void QPen::setWidth(int width)

将笔宽设置为指定的width （以像素为单位，采用整数精度）。

线宽为零表示装饰性画笔。这意味着画笔宽度始终以一像素的宽度绘制，与在绘图器上设置的transformation 值无关。

不支持设置负值的笔宽。

另请参阅 setWidthF() 和width()。

void QPen::setWidthF(qreal width)

将笔宽设置为指定为“width ”的像素值，采用浮点精度。

线宽为零表示装饰性画笔。这意味着画笔的宽度始终为一个像素，与绘图器上的transformation 值无关。

不支持将画笔宽度设置为负值。

另请参阅 setWidth() 和widthF()。

Qt::PenStyle QPen::style() const

返回笔触样式。

另请参阅 setStyle() 和Pen Style 。

[noexcept] void QPen::swap(QPen &other)

将这支笔与other 互换。此操作非常快速，且从未失败。

int QPen::width() const

返回笔宽，精度为整数。

另请参阅 setWidth() 和widthF()。

qreal QPen::widthF() const

返回具有浮点精度的笔宽。

另请参阅 setWidthF() 和width()。

QPen::operator QVariant() const

将笔作为QVariant 返回。

bool QPen::operator!=(const QPen &pen) const

如果该笔与给定的pen 不同，则返回true ；否则返回 false。当两支笔的样式、宽度或颜色不同时，即视为不同。

另请参阅 operator==()。

[noexcept] QPen &QPen::operator=(QPen &&other)

将other 通过move-assign操作赋值给此QPen 实例。

[noexcept] QPen &QPen::operator=(const QPen &pen)

将给定的pen 分配给这支笔，并返回对这支笔的引用。

[since 6.9] QPen &QPen::operator=(QColor color)

将此笔设置为指定颜色的实心笔，并采用默认的笔帽和连接样式，同时返回对此笔的引用。

该函数在 Qt 6.9 中引入。

[since 6.9] QPen &QPen::operator=(Qt::PenStyle style)

将此笔设置为一款实心黑色笔，采用默认的笔帽和笔身连接样式，并返回对此笔的引用。

该函数在 Qt 6.9 中引入。

bool QPen::operator==(const QPen &pen) const

如果该笔与给定的pen 相等，则返回true ；否则返回 false。当两支笔的样式、宽度和颜色相同时，即视为相等。

另请参阅 operator!=()。