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 的副本。

[noexcept] 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 像素。请注意，宽度为 0 的笔相当于宽度为 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 XML 4.1 起，还可以使用setDashPattern() 函数指定自定义的破折号样式，该函数会将钢笔样式隐式转换为Qt::CustomDashLine 。

另请参阅 style() 和Pen Style 。

void QPen::setWidth(int width)

以整数精度将钢笔宽度设置为给定的width （像素）。

线宽为 0 时，表示画笔是整洁的。这意味着笔宽始终为一个像素宽度，与绘制器上设置的transformation 无关。

不支持设置负值的笔宽。

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

void QPen::setWidthF(qreal width)

以浮点精度将笔宽度设置为给定的width （像素）。

线宽为 0 时，表示画笔是整洁的。这意味着画笔宽度始终为一个像素宽，与画板上的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()。

QVariant QPen::operator QVariant() const

以QVariant 的形式返回钢笔。

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

如果笔与给定的pen 不同，则返回true ；否则返回 false。如果两支笔的样式、宽度或颜色不同，则它们是不同的。

另请参见 operator==()。

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

Move-assignsother 到此QPen 实例。

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

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

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

如果笔等于给定的pen ，则返回true ；否则返回 false。如果两支笔的样式、宽度和颜色相同，则它们相等。

另请参阅 operator!=()。