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

Dokumentation der Mitgliedsfunktionen

QPen::QPen()

Konstruiert einen schwarzen Standard-Volltonstift mit 1 Breite.

QPen::QPen(Qt::PenStyle style)

Konstruiert einen schwarzen Stift mit 1 Breite und der angegebenen style.

Siehe auch setStyle().

QPen::QPen(const QColor &color)

Konstruiert einen einfarbigen Stift mit 1 Breite und der angegebenen color.

Siehe auch setBrush() und setColor().

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

Konstruiert einen Stift mit dem angegebenen brush, width, pen style, cap style und join style.

Siehe auch setBrush(), setWidth(), setStyle(), setCapStyle(), und setJoinStyle().

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

Konstruiert einen Stift, der eine Kopie des angegebenen pen ist.

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

Konstruiert einen Stift, der aus dem angegebenen pen verschoben wird.

Der verschobene Stift kann nur zugewiesen, kopiert oder zerstört werden. Jede andere Operation (vor der Zuweisung) führt zu undefiniertem Verhalten.

[noexcept] QPen::~QPen()

Zerstört den Stift.

QBrush QPen::brush() const

Gibt den Pinsel zurück, der zum Füllen der mit diesem Stift erzeugten Striche verwendet wird.

Siehe auch setBrush().

Qt::PenCapStyle QPen::capStyle() const

Gibt den Kappenstil des Stifts zurück.

Siehe auch setCapStyle() und Cap Style.

QColor QPen::color() const

Gibt die Farbe des Pinsels dieses Stifts zurück.

Siehe auch brush() und setColor().

qreal QPen::dashOffset() const

Gibt den Strichversatz für den Stift zurück.

Siehe auch setDashOffset().

QList<qreal> QPen::dashPattern() const

Gibt das Strichmuster dieses Stifts zurück.

Siehe auch setDashPattern(), style(), und isSolid().

bool QPen::isCosmetic() const

Gibt true zurück, wenn es sich um einen kosmetischen Stift handelt; andernfalls wird false zurückgegeben.

Kosmetische Stifte werden verwendet, um Striche zu zeichnen, die eine konstante Breite haben, unabhängig von den Transformationen, die auf die QPainter angewendet werden. Das Zeichnen einer Form mit einem kosmetischen Stift stellt sicher, dass ihr Umriss bei verschiedenen Skalierungsfaktoren die gleiche Dicke hat.

Ein Stift mit der Breite Null ist standardmäßig kosmetisch.

Siehe auch setCosmetic() und widthF().

bool QPen::isSolid() const

Gibt true zurück, wenn der Stift eine feste Füllung hat, sonst false.

Siehe auch style() und dashPattern().

Qt::PenJoinStyle QPen::joinStyle() const

Gibt den Verbindungsstil des Stifts zurück.

Siehe auch setJoinStyle() und Join Style.

qreal QPen::miterLimit() const

Gibt die Gehrungsgrenze des Stiftes zurück. Die Gehrungsgrenze ist nur relevant, wenn der Verbindungsstil auf Qt::MiterJoin eingestellt ist.

Siehe auch setMiterLimit() und Join Style.

void QPen::setBrush(const QBrush &brush)

Setzt den Pinsel, der zum Füllen der mit diesem Stift erzeugten Striche verwendet wird, auf den angegebenen brush.

Siehe auch brush() und setColor().

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

Setzt den Kappenstil des Stiftes auf den angegebenen style. Der Standardwert ist Qt::SquareCap.

Siehe auch capStyle() und Cap Style.

void QPen::setColor(const QColor &color)

Setzt die Farbe des Pinsels dieses Stifts auf die angegebene color.

Siehe auch setBrush() und color().

void QPen::setCosmetic(bool cosmetic)

Setzt diesen Stift auf kosmetisch oder nicht-kosmetisch, je nach dem Wert von cosmetic.

Siehe auch isCosmetic().

void QPen::setDashOffset(qreal offset)

Setzt den Strichversatz (den Startpunkt des Strichmusters) für diesen Stift auf die angegebene Adresse offset. Der Versatz wird in den Einheiten gemessen, die zur Angabe des Strichmusters verwendet wurden.

Siehe auch dashOffset().

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

Setzt das Strichmuster für diesen Stift auf den angegebenen pattern. Dadurch wird der Stil des Stifts implizit in Qt::CustomDashLine umgewandelt.

Das Muster muss als eine gerade Anzahl von positiven Einträgen angegeben werden, wobei die Einträge 1, 3, 5... die Striche und 2, 4, 6... die Leerzeichen sind. Ein Beispiel:

Das Strichmuster wird in Einheiten der Stiftbreite angegeben; z. B. ist ein Strich der Länge 5 bei einer Breite von 10 50 Pixel lang. Beachten Sie, dass ein Stift mit der Breite Null einem kosmetischen Stift mit einer Breite von 1 Pixel entspricht.

Jeder Strich unterliegt auch dem Kappenstil, so dass ein Strich der Länge 1 mit quadratischer Kappe in jeder Richtung 0,5 Pixel breit ist, was eine Gesamtbreite von 2 ergibt.

Beachten Sie, dass der Standard-Kappenstil Qt::SquareCap ist, was bedeutet, dass ein quadratisches Linienende den Endpunkt abdeckt und um die Hälfte der Linienbreite darüber hinausgeht.

Siehe auch setStyle(), dashPattern(), setCapStyle(), und setCosmetic().

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

Setzt den Verbindungsstil des Stifts auf den angegebenen style. Der Standardwert ist Qt::BevelJoin.

Siehe auch joinStyle() und Join Style.

void QPen::setMiterLimit(qreal limit)

Setzt die Gehrungsgrenze dieses Stiftes auf die angegebene limit.

Die Gehrungsgrenze beschreibt, wie weit sich eine Gehrungsverbindung vom Verbindungspunkt aus erstrecken kann. Dies wird verwendet, um Artefakte zwischen Linienverbindungen zu reduzieren, wenn die Linien nahezu parallel sind.

Dieser Wert wirkt sich nur aus, wenn der Stiftstil auf Qt::MiterJoin eingestellt ist. Der Wert wird in Einheiten der Stiftbreite angegeben, z. B. ist eine Gehrungsgrenze von 5 bei Breite 10 50 Pixel lang. Die Standardgehrungsgrenze ist 2, d. h. das Doppelte der Stiftbreite in Pixeln.

Siehe auch miterLimit(), setJoinStyle(), und Join Style.

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

Setzt den Stiftstil auf den angegebenen style.

In der Dokumentation Qt::PenStyle finden Sie eine Liste der verfügbaren Stile. Seit Qt 4.1 ist es auch möglich, ein benutzerdefiniertes Strichmuster zu spezifizieren, indem man die Funktion setDashPattern() verwendet, die den Stil des Stifts implizit in Qt::CustomDashLine konvertiert.

Siehe auch style() und Pen Style.

void QPen::setWidth(int width)

Setzt die Stiftbreite auf die angegebene width in Pixeln mit ganzzahliger Genauigkeit.

Eine Linienbreite von Null bedeutet einen kosmetischen Stift. Das bedeutet, dass die Stiftbreite immer ein Pixel breit gezeichnet wird, unabhängig von der Einstellung transformation im Painter.

Die Einstellung einer Stiftbreite mit einem negativen Wert wird nicht unterstützt.

Siehe auch setWidthF() und width().

void QPen::setWidthF(qreal width)

Setzt die Stiftbreite auf die angegebene width in Pixeln mit Fließkommagenauigkeit.

Eine Linienbreite von Null bedeutet einen kosmetischen Stift. Das bedeutet, dass die Stiftbreite immer ein Pixel breit gezeichnet wird, unabhängig von der transformation auf dem Painter.

Das Setzen einer Stiftbreite mit einem negativen Wert wird nicht unterstützt.

Siehe auch setWidth() und widthF().

Qt::PenStyle QPen::style() const

Gibt den Stiftstil zurück.

Siehe auch setStyle() und Pen Style.

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

Tauscht diesen Stift mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

int QPen::width() const

Gibt die Stiftbreite mit ganzzahliger Genauigkeit zurück.

Siehe auch setWidth() und widthF().

qreal QPen::widthF() const

Gibt die Stiftbreite mit Fließkommagenauigkeit zurück.

Siehe auch setWidthF() und width().

QVariant QPen::operator QVariant() const

Gibt den Stift als QVariant zurück.

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

Gibt true zurück, wenn sich der Stift von dem angegebenen pen unterscheidet; andernfalls false. Zwei Stifte sind verschieden, wenn sie unterschiedliche Stile, Breiten oder Farben haben.

Siehe auch operator==().

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

Verschieben - weist other dieser QPen Instanz zu.

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

Weist diesem Stift die angegebene pen zu und gibt einen Verweis auf diesen Stift zurück.

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

Gibt true zurück, wenn der Stift gleich dem angegebenen pen ist; andernfalls false. Zwei Stifte sind gleich, wenn sie die gleichen Stile, Breiten und Farben haben.

Siehe auch operator!=().