Sur cette page

QCanvasGridPattern Class

QCanvasGridPattern est une brosse pour peindre des motifs de grille. Plus d'informations...

En-tête : #include <QCanvasGridPattern>
CMake : find_package(Qt6 REQUIRED COMPONENTS CanvasPainter)
target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter)
Depuis : Qt 6.11
Hérite : QCanvasBrush
Statut : Technical Preview

Fonctions publiques

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)

Description détaillée

QCanvasGridPattern est un pinceau pour peindre des motifs de grilles et de barres.

Voici un exemple simple :

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

Fonction membre Documentation

QCanvasGridPattern::QCanvasGridPattern()

Construit un motif de grille par défaut. La position de départ du motif est (0, 0) et la taille du motif (100, 100). L'angle du motif est de 0,0, la couleur des lignes de la grille est blanche et celle de l'arrière-plan est noire.

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)

Construit un motif de grille. La position de départ et la taille du motif sont définies à l'aide de rect. La couleur de la ligne de grille est lineColor et la couleur d'arrière-plan est backgroundColor. La largeur de la ligne de grille est lineWidth, la plume (anti-crénelage) est feather et l'angle est 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)

Construit un motif de grille. La position de départ du motif est ( x, y) et la taille du motif ( width, height). La couleur de la ligne de grille est lineColor et la couleur d'arrière-plan est backgroundColor. L'angle du motif est angle.

[noexcept] QCanvasGridPattern::~QCanvasGridPattern()

Détruit la grille.

QColor QCanvasGridPattern::backgroundColor() const

Renvoie la couleur d'arrière-plan de la grille de motifs.

Voir aussi setBackgroundColor().

QSizeF QCanvasGridPattern::cellSize() const

Renvoie la taille d'une seule cellule dans la grille.

Voir également setCellSize().

float QCanvasGridPattern::feather() const

Renvoie l'épaisseur du motif en pixels.

Voir également setFeather().

QColor QCanvasGridPattern::lineColor() const

Renvoie la couleur de la ligne de grille du motif.

Voir aussi setLineColor().

float QCanvasGridPattern::lineWidth() const

Renvoie la largeur d'une ligne de trait dans la grille.

Voir également setLineWidth().

float QCanvasGridPattern::rotation() const

Renvoie la rotation du modèle en radians.

Voir également setRotation().

void QCanvasGridPattern::setBackgroundColor(const QColor &color)

Définit la couleur d'arrière-plan de la grille de motifs à color. La valeur par défaut est le noir.

Voir également backgroundColor().

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

Définit la taille d'une cellule unique dans la grille à width, height. Lorsque la largeur est 0, les barres horizontales ne sont pas peintes. Lorsque la hauteur est 0, les barres verticales ne sont pas peintes. La valeur par défaut est (10, 10).

Voir également cellSize().

void QCanvasGridPattern::setCellSize(QSizeF size)

Définit la taille d'une cellule unique dans la grille à size. Lorsque la largeur est 0, les barres horizontales ne sont pas peintes. Lorsque la hauteur est 0, les barres verticales ne sont pas peintes. La valeur par défaut est (10, 10).

Il s'agit d'une fonction surchargée.

void QCanvasGridPattern::setFeather(float feather)

Définit le motif de la plume à feather en pixels. La valeur par défaut est 1.0, ce qui signifie un anticrénelage d'un seul pixel.

Voir également feather().

void QCanvasGridPattern::setLineColor(const QColor &color)

Définit la couleur de la ligne de grille du motif à color. La valeur par défaut est le blanc.

Voir également lineColor().

void QCanvasGridPattern::setLineWidth(float width)

Définit la largeur d'une ligne de trait dans un motif de grille à width. La valeur par défaut est 1.0.

Voir également lineWidth().

void QCanvasGridPattern::setRotation(float rotation)

Définit la rotation du motif à rotation en radians. La rotation se fait autour de la grille startPosition(). La valeur par défaut est 0.0, ce qui signifie que la grille n'est pas tournée.

Voir aussi rotation().

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

Définit le point de départ de la grille à (x, y). La position de départ correspond au coin supérieur gauche de la grille dans le motif. Le motif sera ensuite étendu à toutes les positions à partir de cette position. La valeur par défaut est (0.0, 0.0).

Voir également startPosition().

void QCanvasGridPattern::setStartPosition(QPointF point)

Définit le point de départ de la grille à point. La position de départ correspond au coin supérieur gauche de la grille dans la grille. Le motif sera ensuite étendu à toutes les positions à partir de cette position. La valeur par défaut est (0.0, 0.0).

Il s'agit d'une fonction surchargée.

QPointF QCanvasGridPattern::startPosition() const

Renvoie le point de départ de la grille.

Voir également setStartPosition().

QCanvasGridPattern::operator QVariant() const

Renvoie le motif de la grille sous forme de QVariant.

Non-membres apparentés

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

Renvoie true si le motif de la grille lhs est différent de rhs; false dans le cas contraire.

Voir aussi operator==().

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

Écrit la donnée pattern dans la donnée stream et renvoie une référence à stream.

Voir aussi Serializing Qt Data Types (Sérialisation des types de données Qt).

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

Renvoie true si le motif de la grille lhs est égal à rhs; false dans le cas contraire.

Voir aussi operator!=().

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

Lit la donnée pattern à partir de la donnée stream et renvoie une référence à la donnée stream.

Voir aussi Serializing Qt Data Types (Sérialisation des types de données Qt).

© 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.