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 style およびjoin style を持つペンを構築します。

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 に設定 さ れてい る と き にのみ効力を持ち ます。 こ の値はペ ンの幅を単位 と し て指定 さ れます。デフォルトのマイターリミットは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 に設定する。

線幅ゼロは、化粧ペンを示す。これは、ペインタに設定されたtransformation とは無関係に、ペン幅が常に1ピクセル幅で描画されることを意味します。

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

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

void QPen::setWidthF(qreal width)

ペン幅を、浮動小数点精度でピクセル単位で与えられたwidth に設定します。

線幅ゼロは、化粧ペンを示します。これは、ペインター上の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() も参照 。

QVariant QPen::operator QVariant() const

ペンをQVariant として返します。

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

ペンが与えられたpen と異なる場合はtrue を返し、そうでない場合は false を返します。2つのペンが異なるスタイル、幅、色を持っている場合、2つのペンは異なります。

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

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

Move-other をこのQPen インスタンスに割り当てます。

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

与えられたpen をこのペンに割り当て、このペンへの参照を返す。

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

ペンが与えられたpen と等しい場合はtrue を返し、そうでない場合は false を返します。2つのペンのスタイル、幅、色が等しい場合は等しい。

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