Auf dieser Seite

QCanvasGridPattern Class

QCanvasGridPattern ist ein Pinsel zum Zeichnen von Rastermustern. Mehr...

Überschrift: #include <QCanvasGridPattern>
CMake: find_package(Qt6 REQUIRED COMPONENTS CanvasPainter)
target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter)
Seit: Qt 6.11

Öffentliche Funktionen

QCanvasGridPattern(QPointF startPosition, QSizeF cellSize)
QCanvasGridPattern(qreal startX, qreal startY, qreal cellWidth, qreal cellHeight)
QCanvasGridPattern(const QCanvasGridPattern &)
QCanvasGridPattern(QCanvasGridPattern &&)
QColor backgroundColor() const
QSizeF cellSize() const
qreal feather() const
QColor lineColor() const
qreal lineWidth() const
qreal rotation() const
void setBackgroundColor(QColor color)
void setCellSize(qreal width, qreal height)
void setCellSize(QSizeF size)
void setFeather(qreal feather)
void setLineColor(QColor color)
void setLineWidth(qreal width)
void setRotation(qreal rotation)
void setStartPosition(qreal x, qreal y)
void setStartPosition(QPointF point)
QPointF startPosition() const
operator QVariant() const
bool operator!=(const QCanvasGridPattern &lhs, const QCanvasGridPattern &rhs)
QDataStream &operator<<(QDataStream &stream, const QCanvasGridPattern &pattern)
bool operator==(const QCanvasGridPattern &lhs, const QCanvasGridPattern &rhs)
QDataStream &operator>>(QDataStream &stream, QCanvasGridPattern &pattern)

Ausführliche Beschreibung

QCanvasGridPattern ist ein Pinsel zum Zeichnen von Raster- und Balkenmustern.

Hier ist ein einfaches Beispiel:

// Rotated grid into background
QRectF rect(20, 20, 180, 180);
QCanvasGridPattern gp1(rect.topLeft(), QSizeF(16, 16));
gp1.setLineColor("#DBEB00");
gp1.setBackgroundColor("#373F26");
gp1.setLineWidth(2.0);
gp1.setRotation(M_PI / 4);
gp1.setFeather(5.0);
painter.setFillStyle(gp1);
painter.fillRect(rect);
// Rounded rectangle, stroked with
// grid pattern for dashes.
qreal strokeW = 10;
QRectF rect2(40, 40, 140, 140);
QCanvasGridPattern gp2;
gp2.setLineColor(Qt::transparent);
gp2.setBackgroundColor(Qt::white);
gp2.setStartPosition(rect2.x() - strokeW,
                     rect2.y() - strokeW);
gp2.setCellSize(40, 40);
gp2.setLineWidth(strokeW);
painter.setLineWidth(8);
painter.setStrokeStyle(gp2);
painter.beginPath();
painter.roundRect(rect2, 10);
painter.stroke();

Ein abgerundetes Quadrat, gefüllt mit einem gelben diagonalen Raster und umrandet von einem gestrichelten weißen Rand

Dokumentation der Mitgliedsfunktionen

QCanvasGridPattern::QCanvasGridPattern(QPointF startPosition, QSizeF cellSize)

Erzeugt ein Rastermuster, das bei startPosition beginnt, wobei die Größe einer einzelnen Zelle cellSize beträgt.

Siehe auch setStartPosition() und setCellSize().

QCanvasGridPattern::QCanvasGridPattern(qreal startX, qreal startY, qreal cellWidth, qreal cellHeight)

Erstellt ein Rastermuster, beginnend bei startX und startY, wobei eine einzelne Zelle die Größe cellWidth und cellHeight hat.

Siehe auch setLineColor(), setBackgroundColor(), setLineWidth(), setFeather() und setRotation().

QCanvasGridPattern::QCanvasGridPattern(const QCanvasGridPattern &)

Zerstört das Rastermuster.

[constexpr noexcept default] QCanvasGridPattern::QCanvasGridPattern(QCanvasGridPattern &&)

Erstellt eine Instanz von ` QCanvasGridPattern` mithilfe von `Move`.

QColor QCanvasGridPattern::backgroundColor() const

Gibt die Hintergrundfarbe des Musterrasters zurück.

Siehe auch „ setBackgroundColor()“.

QSizeF QCanvasGridPattern::cellSize() const

Gibt die Größe einer einzelnen Zelle im Rastermuster zurück.

Siehe auch „ setCellSize()“.

qreal QCanvasGridPattern::feather() const

Gibt das Muster „feather“ in Pixeln zurück.

Siehe auch „ setFeather()“.

QColor QCanvasGridPattern::lineColor() const

Gibt die Farbe der Rasterlinien des Musters zurück.

Siehe auch setLineColor().

qreal QCanvasGridPattern::lineWidth() const

Gibt die Breite einer Strichlinie im Rastermuster zurück.

Siehe auch „ setLineWidth()“.

qreal QCanvasGridPattern::rotation() const

Gibt die Drehung des Musters in Radianten zurück.

Siehe auch „ setRotation()“.

void QCanvasGridPattern::setBackgroundColor(QColor color)

Legt die Hintergrundfarbe des Musterrasters auf „ color “ fest. Der Standardwert ist Schwarz.

Siehe auch backgroundColor().

void QCanvasGridPattern::setCellSize(qreal width, qreal height)

Legt die Größe einer einzelnen Zelle im Rastermuster auf „ width “ oder „ height “ fest. Wenn die Breite auf „ 0 “ gesetzt ist, werden die horizontalen Balken nicht gezeichnet. Wenn die Höhe auf „ 0 “ gesetzt ist, werden die vertikalen Balken nicht gezeichnet. Der Standardwert ist „ (10, 10) “.

Siehe auch cellSize().

void QCanvasGridPattern::setCellSize(QSizeF size)

Legt die Größe einer einzelnen Zelle im Rastermuster auf „ size “ fest. Wenn die Breite auf „ 0 “ gesetzt ist, werden die horizontalen Balken nicht gezeichnet. Wenn die Höhe auf „ 0 “ gesetzt ist, werden die vertikalen Balken nicht gezeichnet. Der Standardwert ist „ (10, 10) “.

Dies ist eine überladene Funktion.

void QCanvasGridPattern::setFeather(qreal feather)

Legt die Musterausblendung auf „ feather “ in Pixeln fest. Der Standardwert ist „ 1.0 “, was einer Antialiasing-Stufe von einem Pixel entspricht.

Siehe auch „ feather()“.

void QCanvasGridPattern::setLineColor(QColor color)

Legt die Farbe der Musterrasterlinien auf „ color “ fest. Der Standardwert ist „weiß“.

Siehe auch lineColor().

void QCanvasGridPattern::setLineWidth(qreal width)

Legt die Breite einer Strichlinie im Rastermuster auf „ width “ fest. Der Standardwert ist „ 1.0 “.

Siehe auch ` lineWidth()`.

void QCanvasGridPattern::setRotation(qreal rotation)

Legt die Drehung des Musters auf ` rotation ` in Radianten fest. Die Drehung erfolgt um das Raster ` startPosition()`. Der Standardwert ist ` 0.0`, was bedeutet, dass das Raster nicht gedreht wird.

Siehe auch rotation().

void QCanvasGridPattern::setStartPosition(qreal x, qreal y)

Legt den Startpunkt des Rastermusters auf (x, y) fest. Die Startposition bezeichnet die obere linke Ecke des Rasters im Muster. Das Muster wird dann von dieser Position aus auf alle Positionen ausgeweitet. Der Standardwert ist (0.0, 0.0).

Siehe auch startPosition().

void QCanvasGridPattern::setStartPosition(QPointF point)

Legt den Startpunkt des Rastermusters auf „ point “ fest. Die Startposition entspricht der oberen linken Ecke des Rasters im Muster. Das Muster wird dann von dieser Position aus auf alle Positionen ausgedehnt. Der Standardwert ist „ (0.0, 0.0) “.

Dies ist eine überladene Funktion.

QPointF QCanvasGridPattern::startPosition() const

Gibt den Startpunkt des Rastermusters zurück.

Siehe auch „ setStartPosition()“.

QCanvasGridPattern::operator QVariant() const

Gibt das Rastermuster als ` QVariant` zurück.

Verwandte Nicht-Mitglieder

[noexcept] bool operator!=(const QCanvasGridPattern &lhs, const QCanvasGridPattern &rhs)

Gibt „ true “ zurück, wenn sich das Rastermuster „ lhs “ von „ rhs “ unterscheidet; andernfalls „ false “.

Siehe auch operator==().

QDataStream &operator<<(QDataStream &stream, const QCanvasGridPattern &pattern)

Schreibt die angegebene ` pattern ` in die angegebene ` stream ` und gibt eine Referenz auf die ` stream` zurück.

Siehe auch „Serialisierung vonQt-Datentypen“.

[noexcept] bool operator==(const QCanvasGridPattern &lhs, const QCanvasGridPattern &rhs)

Gibt „ true “ zurück, wenn das Rastermuster „ lhs “ gleich „ rhs “ ist; andernfalls „ false “.

Siehe auch operator!=().

QDataStream &operator>>(QDataStream &stream, QCanvasGridPattern &pattern)

Liest den angegebenen „ pattern “ aus dem angegebenen „ stream “ und gibt eine Referenz auf den „ stream “ zurück.

Siehe auch „Serialisierung vonQt-Datentypen“.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.