QPen类

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的实线笔并具有指定的颜色。

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

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

创建一个具有指定笔刷、宽度、笔样式、端点样式和连接样式的笔。

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

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

构造一个复制给定的

笔

。

[noexcept] QPen::QPen(QPen &&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() 和 连接样式。

qreal QPen::miterLimit() const

返回笔的倒角限制。只有当连接样式设置为 Qt::MiterJoin 时，倒角限制才相关。

另请参阅setMiterLimit() 和 连接样式。

void QPen::setBrush(const QBrush &brush)

将此笔生成的描边所使用的画笔设置为指定的 brush。

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

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

将笔端样式设置为给定的 style。默认值是 Qt::SquareCap。

另请参阅capStyle() 和 端样式。

void QPen::setColor(const QColor &color)

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

另请参阅setBrush() 和 颜色。

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... 是间隙。例如

虚线图案的单位是画笔的宽度；例如，长度为 5 的划线在 10 的宽度上为 50 像素长。请注意，宽度为零的画笔相当于宽度为 1 像素的装饰性画笔。

每个划线也受盖帽样式的影响，因此设置为方形盖帽的划线将在每个方向上延伸 0.5 像素，从而使得总宽度为 2。

请注意，默认盖帽样式为Qt::SquareCap，这意味着方线端点覆盖终点并延伸到终点之外线宽的一半。

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

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

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

另请参阅 joinStyle()和连接样式。

void QPen::setMiterLimit(qreal limit)

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

斜接限制描述了斜接连接可以延伸多远。这用于减少线连接处的伪影，其中线条几乎平行。

该值仅在画笔样式设置为Qt::MiterJoin时才有效。该值以画笔宽度的单位指定，例如，宽度为 10 的 5 的斜接限制为 50 像素长。默认斜接限制为 2，即像素宽度的两倍。

另请参阅 miterLimit、setJoinStyle和连接样式。

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

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

有关可用的样式列表，请参阅Qt::PenStyle文档。从 Qt 4.1 开始，也可以使用setDashPattern()函数指定自定义的划线图案，这将隐式地将画笔样式转换为Qt::CustomDashLine。

另请参阅 style和笔样式。

void QPen::setWidth(int width)

以像素为单位以整数精度设置画笔宽度为给定的width。

线条宽度为零表示装饰性笔。这意味着笔宽度始终绘制为单像素宽度，不受画家设置的变换的影响。

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

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

void QPen::setWidthF(qreal width)

将笔宽度设置为给定的宽度像素值，具有浮点精度。

线条宽度为零表示装饰性笔。这意味着笔宽度始终绘制为单像素宽度，不受画家上的变换影响。

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

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

Qt::PenStyle QPen::style() const

返回笔样式。

另请参阅 setStyle() 和 笔样式。

[noexcept] void QPen::swap(QPen &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

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

另请参阅 operator==。

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

将给定的笔赋值到此笔，并返回对此笔的引用。

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

将other移动分配到该QPen实例。

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

如果笔与给定笔相等，则返回 true；否则返回 false。如果两个笔的样式、宽度以及颜色都相等，则它们是相等的。

另请参阅 operator!=。