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 Member-Funktionen

QPen::QPen()

Erstellt einen standardmäßigen schwarzen durchgezogenen Strich mit der Breite 1.

QPen::QPen(Qt::PenStyle style)

Erstellt einen schwarzen Stift mit der Breite 1 und dem angegebenen style.

Siehe auch ` setStyle()`.

QPen::QPen(const QColor &color)

Erzeugt einen Stift für durchgezogene Linien mit der Breite 1 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)

Erstellt einen Stift mit den angegebenen Stilen „ brush “, „ width “, „pen style “, „ cap “ und „ join “.

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

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

Erzeugt einen Stift, der eine Kopie des angegebenen „ pen “ ist.

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

Erstellt einen Stift, der aus dem angegebenen „ pen “ verschoben wurde.

Der aus „xml-ph-0000@deepl.internal“ verschobene Pen 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 Ausfüllen der mit diesem Stift erzeugten Striche verwendet wird.

Siehe auch „ setBrush()“.

Qt::PenCapStyle QPen::capStyle() const

Gibt den Stil der Stiftkappe 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 Kosmetikstift handelt; andernfalls wird „ false “ zurückgegeben.

Kosmetische Stifte werden verwendet, um Striche zu zeichnen, die unabhängig von den auf den QPainter, mit dem sie verwendet werden, angewendeten Transformationen eine konstante Breite aufweisen. Das Zeichnen einer Form mit einem kosmetischen Stift stellt sicher, dass ihr Umriss bei unterschiedlichen Skalierungsfaktoren die gleiche Dicke aufweist.

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

Siehe auch „ setCosmetic()“ und „ widthF()“.

bool QPen::isSolid() const

Gibt „ true “ zurück, wenn der Stift eine durchgehende Füllung hat, andernfalls „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 den Gehrungsgrenzwert des Stifts zurück. Der Gehrungsgrenzwert ist nur relevant, wenn der Fugenstil auf „ Qt::MiterJoin “ gesetzt ist.

Siehe auch „ setMiterLimit()“ und „ Join Style “.

void QPen::setBrush(const QBrush &brush)

Legt den Pinsel fest, der zum Ausfü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 Stil der Stiftkappe auf den angegebenen Wert „ style “. Der Standardwert ist „ Qt::SquareCap “.

Siehe auch capStyle() und Cap Style.

void QPen::setColor(const QColor &color)

Legt die Farbe des Pinsels dieses Stifts auf den angegebenen Wert „ color “ fest.

Siehe auch setBrush() und color().

void QPen::setCosmetic(bool cosmetic)

Legt fest, ob dieser Stift kosmetisch oder nicht-kosmetisch ist, abhängig vom Wert von „ cosmetic “.

Siehe auch ` isCosmetic()`.

void QPen::setDashOffset(qreal offset)

Legt den Strichversatz (den Startpunkt des Strichmusters) für diesen Stift auf den angegebenen Wert „ offset “ fest. Der Versatz wird in den Einheiten gemessen, die zur Festlegung des Strichmusters verwendet werden.

Siehe auch ` dashOffset()`.

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

Legt das Strichmuster für diesen Stift auf das angegebene „ pattern “ fest. Dadurch wird der Stil des Stifts implizit in „ Qt::CustomDashLine “ umgewandelt.

Das Muster muss als gerade Anzahl positiver Einträge angegeben werden, wobei die Einträge 1, 3, 5… die Striche und 2, 4, 6… die Lücken darstellen. Zum 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 zudem den Endstil-Einstellungen, sodass ein Strich der Länge 1 mit dem Endstil „quadratisch“ in jede Richtung um 0,5 Pixel über den Strich hinausragt, was zu einer Gesamtbreite von 2 führt.

Beachten Sie, dass der Standard-Endstil „ Qt::SquareCap “ ist, was bedeutet, dass ein quadratisches Linienende den Endpunkt bedeckt und um die Hälfte der Linienbreite darüber hinausragt.

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

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

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

Siehe auch „ joinStyle()“ und „ Join Style “.

void QPen::setMiterLimit(qreal limit)

Legt die Gehrungsgrenze dieses Stifts auf den angegebenen Wert „ limit “ fest.

Die Gehrungsgrenze beschreibt, wie weit sich eine Gehrungsverbindung vom Verbindungspunkt aus erstrecken darf. Dies dient dazu, Artefakte zwischen Linienverbindungen zu reduzieren, bei denen die Linien nahezu parallel verlaufen.

Dieser Wert wirkt sich nur aus, wenn der Stiftstil auf „ Qt::MiterJoin “ eingestellt ist. Der Wert wird in Einheiten der Stiftbreite angegeben, z. B. beträgt eine Gehrungsbegrenzung von 5 bei einer Breite von 10 eine Länge von 50 Pixeln. Die Standard-Gehrungsbegrenzung beträgt 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 “.

Eine Liste der verfügbaren Stile finden Sie in der Dokumentation zu „ Qt::PenStyle “. Seit Qt 4.1 ist es außerdem möglich, mithilfe der Funktion „ setDashPattern()“ ein benutzerdefiniertes Strichmuster anzugeben, wodurch der Stil des Stifts implizit in „ Qt::CustomDashLine “ umgewandelt wird.

Siehe auch „ style()“ und „ Pen Style “.

void QPen::setWidth(int width)

Stellt die Stiftbreite auf den angegebenen Wert „ width “ in Pixeln mit ganzzahliger Genauigkeit ein.

Eine Linienbreite von Null weist auf einen kosmetischen Stift hin. Das bedeutet, dass die Stiftbreite immer ein Pixel breit gezeichnet wird, unabhängig von der für den Painter festgelegten „ transformation “.

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

Siehe auch „ setWidthF()“ und „ width()“.

void QPen::setWidthF(qreal width)

Stellt die Stiftbreite auf die angegebene width in Pixeln mit Gleitkommagenauigkeit ein.

Eine Linienbreite von Null kennzeichnet einen kosmetischen Stift. Das bedeutet, dass die Stiftbreite unabhängig von der im „ transformation “ des „Painter“ festgelegten Einstellung stets mit einer Breite von einem Pixel gezeichnet wird.

Die Einstellung 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)

Tausche diesen Stift gegen other aus. Dieser Vorgang ist sehr schnell und funktioniert immer.

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 Gleitkommagenauigkeit zurück.

Siehe auch „ setWidthF()“ und „ width()“.

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 vom angegebenen „ pen “ unterscheidet; andernfalls „false“. Zwei Stifte unterscheiden sich, wenn sie unterschiedliche Stile, Breiten oder Farben haben.

Siehe auch operator==().

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

Weist „ other “ dieser „ QPen “-Instanz zu.

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

Weist diesem Stift den angegebenen „ pen “ zu und gibt eine Referenz auf diesen Stift zurück.

[since 6.9] QPen &QPen::operator=(QColor color)

Erstellt einen soliden Stift in der angegebenen Farbe mit den Standardausführungen für Kappe und Verbindungsstück und gibt eine Referenz auf diesen Stift zurück.

Diese Funktion wurde in Qt 6.9 eingeführt.

[since 6.9] QPen &QPen::operator=(Qt::PenStyle style)

Macht diesen Stift zu einem einfarbigen, schwarzen Stift mit den Standardausführungen für Kappe und Verbindungsstück und gibt eine Referenz auf diesen Stift zurück.

Diese Funktion wurde in Qt 6.9 eingeführt.

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

Gibt „ true “ zurück, wenn der Stift mit dem angegebenen „ pen “ übereinstimmt; andernfalls „false“. Zwei Stifte sind gleich, wenn sie dieselben Stile, Breiten und Farben aufweisen.

Siehe auch operator!=().