Auf dieser Seite

QCanvasGridPattern Class

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

Kopfzeile: #include <QCanvasGridPattern>
CMake: find_package(Qt6 REQUIRED COMPONENTS CanvasPainter)
target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter)
Seit: Qt 6.11
Erbt: QCanvasBrush
Status: Technische Vorschau

Öffentliche Funktionen

QCanvasGridPattern()
QCanvasGridPattern(const QRectF &rect, const QColor &lineColor = QColorConstants::White, const QColor &backgroundColor = QColorConstants::Black, float lineWidth = 1.0f, float feather = 1.0f, float angle = 0.0f)
QCanvasGridPattern(float x, float y, float width, float height, const QColor &lineColor = QColorConstants::White, const QColor &backgroundColor = QColorConstants::Black, float lineWidth = 1.0f, float feather = 1.0f, float angle = 0.0f)
~QCanvasGridPattern()
QColor backgroundColor() const
QSizeF cellSize() const
float feather() const
QColor lineColor() const
float lineWidth() const
float rotation() const
void setBackgroundColor(const QColor &color)
void setCellSize(float width, float height)
void setCellSize(QSizeF size)
void setFeather(float feather)
void setLineColor(const QColor &color)
void setLineWidth(float width)
void setRotation(float rotation)
void setStartPosition(float x, float 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)

Detaillierte Beschreibung

QCanvasGridPattern ist ein Pinsel zum Malen von Gitter- und Balkenmustern.

Hier ist ein einfaches Beispiel:

// Rotated grid into background
QRectF rect(20, 20, 180, 180);
QCanvasGridPattern gp1(rect, "#DBEB00", "#373F26");
gp1.setCellSize(16, 16);
gp1.setStartPosition(rect.topLeft());
gp1.setLineWidth(2.0f);
gp1.setRotation(M_PI / 4);
gp1.setFeather(5.0f);
painter.setFillStyle(gp1);
painter.fillRect(rect);
// Rounded rectangle, stroked with
// grid pattern for dashes.
float 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();

Member Function Dokumentation

QCanvasGridPattern::QCanvasGridPattern()

Konstruiert ein Standard-Gittermuster. Die Startposition des Musters ist (0, 0) und die Größe des Musters (100, 100). Der Winkel des Musters ist 0,0, die Farbe der Gitterlinien ist weiß und die Hintergrundfarbe schwarz.

QCanvasGridPattern::QCanvasGridPattern(const QRectF &rect, const QColor &lineColor = QColorConstants::White, const QColor &backgroundColor = QColorConstants::Black, float lineWidth = 1.0f, float feather = 1.0f, float angle = 0.0f)

Konstruiert ein Gittermuster. Die Startposition und Größe des Musters wird mit rect definiert. Die Farbe der Rasterlinie ist lineColor und die Hintergrundfarbe ist backgroundColor. Die Breite der Rasterlinie ist lineWidth, die Feder (Antialiasing) ist feather und der Winkel ist angle.

QCanvasGridPattern::QCanvasGridPattern(float x, float y, float width, float height, const QColor &lineColor = QColorConstants::White, const QColor &backgroundColor = QColorConstants::Black, float lineWidth = 1.0f, float feather = 1.0f, float angle = 0.0f)

Konstruiert ein Gittermuster. Die Startposition des Musters ist ( x, y) und die Größe des Musters ( width, height). Die Farbe der Rasterlinie ist lineColor und die Hintergrundfarbe ist backgroundColor. Der Winkel des Musters ist angle.

[noexcept] QCanvasGridPattern::~QCanvasGridPattern()

Zerstört das Gittermuster.

QColor QCanvasGridPattern::backgroundColor() const

Gibt die Hintergrundfarbe des Mustergitters zurück.

Siehe auch setBackgroundColor().

QSizeF QCanvasGridPattern::cellSize() const

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

Siehe auch setCellSize().

float QCanvasGridPattern::feather() const

Liefert die Musterfahne in Pixeln.

Siehe auch setFeather().

QColor QCanvasGridPattern::lineColor() const

Gibt die Farbe der Gitterlinien des Musters zurück.

Siehe auch setLineColor().

float QCanvasGridPattern::lineWidth() const

Gibt die Breite einer Strichlinie im Gittermuster zurück.

Siehe auch setLineWidth().

float QCanvasGridPattern::rotation() const

Gibt die Musterrotation im Bogenmaß zurück.

Siehe auch setRotation().

void QCanvasGridPattern::setBackgroundColor(const QColor &color)

Setzt die Hintergrundfarbe des Mustergitters auf color. Der Standardwert ist schwarz.

Siehe auch backgroundColor().

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

Setzt die Größe einer einzelnen Zelle im Gittermuster auf width, height. Wenn die Breite 0 ist, werden die horizontalen Balken nicht gezeichnet. Wenn die Höhe 0 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 Gittermuster auf size fest. Wenn die Breite 0 ist, werden die horizontalen Balken nicht gezeichnet. Wenn die Höhe 0 ist, werden die vertikalen Balken nicht gezeichnet. Der Standardwert ist (10, 10).

Dies ist eine überladene Funktion.

void QCanvasGridPattern::setFeather(float feather)

Setzt die Musterfeder auf feather in Pixeln. Der Standardwert ist 1.0, d.h. Antialiasing in einem Pixel.

Siehe auch feather().

void QCanvasGridPattern::setLineColor(const QColor &color)

Setzt die Farbe der Rasterlinien auf color. Der Standardwert ist weiß.

Siehe auch lineColor().

void QCanvasGridPattern::setLineWidth(float width)

Setzt die Breite einer Strichlinie im Gittermuster auf width. Der Standardwert ist 1.0.

Siehe auch lineWidth().

void QCanvasGridPattern::setRotation(float rotation)

Setzt die Musterrotation auf rotation im Bogenmaß. Die Drehung erfolgt um das Raster startPosition(). Der Standardwert ist 0.0, was bedeutet, dass das Gitter nicht gedreht wird.

Siehe auch rotation().

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

Setzt den Startpunkt des Rastermusters auf (x, y). Die Startposition ist die linke obere Ecke des Rasters im Muster. Das Muster wird dann von hier aus auf alle Positionen erweitert. Der Standardwert ist (0.0, 0.0).

Siehe auch startPosition().

void QCanvasGridPattern::setStartPosition(QPointF point)

Setzt den Startpunkt des Rastermusters auf point. Die Startposition ist die obere linke Ecke des Rasters im Muster. Das Muster wird dann von hier aus auf alle Positionen erweitert. 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 Gittermuster als QVariant zurück.

Verwandte Nicht-Mitglieder

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

Gibt true zurück, wenn sich das Gittermuster 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 von Qt-Datentypen.

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

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

Siehe auch operator!=().

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

Liest die angegebene pattern aus der angegebenen stream und gibt eine Referenz auf die stream zurück.

Siehe auch Serialisierung von Qt-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.