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 から移動されたペンを生成します。

moved-fromペンは、代入、コピー、または破棄のみが可能です。それ以外の操作（代入前）を行うと、未定義の挙動を引き起こします。

[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、つまりペンの幅の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 をピクセル単位で、整数精度で設定します。

線幅が 0 の場合は、装飾用ペンを示します。これは、ペインターに設定されたtransformation に関係なく、ペン幅が常に 1 ピクセル幅で描画されることを意味します。

負の値でペン幅を設定することはサポートされていません。

setWidthF() およびwidth()も参照してください 。

void QPen::setWidthF(qreal width)

ペン幅を、指定されたwidth （ピクセル単位、浮動小数点精度）に設定します。

線幅が 0 の場合は、装飾用ペンを示します。これは、ペインターのtransformation にかかわらず、ペン幅が常に 1 ピクセル幅で描画されることを意味します。

負の値でペン幅を設定することはサポートされていません。

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を返します。2つのペンが異なるスタイル、幅、または色を持っている場合、それらは異なるものとみなされます。

operator==()も参照してください 。

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

other をこの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を返します。2つのペンが等しいとは、スタイル、幅、色がすべて等しい場合を指します。

operator!=()も参照してください 。