Sur cette page

QCanvasGridPattern Class

QCanvasGridPattern est un pinceau permettant de dessiner des motifs en grille. En savoir plus...

En-tête : #include <QCanvasGridPattern>
CMake : find_package(Qt6 REQUIRED COMPONENTS CanvasPainter)
target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter)
Depuis : Qt 6.11

Fonctions publiques

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)

Description détaillée

QCanvasGridPattern est un pinceau permettant de dessiner des motifs en grille et en barres.

Voici un exemple simple :

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

Carré aux angles arrondis, rempli d'une grille diagonale jaune et bordé d'un trait blanc en pointillés

Documentation des fonctions membres

QCanvasGridPattern::QCanvasGridPattern(QPointF startPosition, QSizeF cellSize)

Crée un motif en grille à partir de startPosition, avec une taille de cellule unique de cellSize.

Voir également setStartPosition() et setCellSize().

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

Crée une grille à partir des points startX et startY, avec une cellule de taille cellWidth et cellHeight.

Voir également setLineColor(), setBackgroundColor(), setLineWidth(), setFeather() et setRotation().

QCanvasGridPattern::QCanvasGridPattern(const QCanvasGridPattern &)

Supprime le quadrillage.

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

Crée par la méthode « move » une instance de ` QCanvasGridPattern`.

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 cellule unique dans une grille.

Voir aussi setCellSize().

qreal QCanvasGridPattern::feather() const

Renvoie le motif « feather » en pixels.

Voir également setFeather().

QColor QCanvasGridPattern::lineColor() const

Renvoie la couleur des lignes de la grille de motifs.

Voir aussi setLineColor().

qreal QCanvasGridPattern::lineWidth() const

Renvoie la largeur d'une ligne de tracé dans un motif en grille.

Voir aussi setLineWidth().

qreal QCanvasGridPattern::rotation() const

Renvoie l'angle de rotation du motif en radians.

Voir aussi setRotation().

void QCanvasGridPattern::setBackgroundColor(QColor color)

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

Voir aussi backgroundColor().

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

Définit la taille d'une cellule individuelle dans une grille selon les valeurs suivantes : width et height. Lorsque la largeur est définie sur 0, les barres horizontales ne sont pas affichées. Lorsque la hauteur est définie sur 0, les barres verticales ne sont pas affichées. La valeur par défaut est (10, 10).

Voir également cellSize().

void QCanvasGridPattern::setCellSize(QSizeF size)

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

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

void QCanvasGridPattern::setFeather(qreal feather)

Définit le lissage du motif à « feather » en pixels. La valeur par défaut est « 1.0 », ce qui correspond à un lissage d’un seul pixel.

Voir également feather().

void QCanvasGridPattern::setLineColor(QColor color)

Définit la couleur des lignes de la grille de motif sur color. La valeur par défaut est le blanc.

Voir aussi lineColor().

void QCanvasGridPattern::setLineWidth(qreal width)

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

Voir également lineWidth().

void QCanvasGridPattern::setRotation(qreal rotation)

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

Voir également rotation().

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

Définit le point de départ du motif de grille sur (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 ce point. 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 du motif de grille sur point. 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 ce point. 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 du motif de grille.

Voir également setStartPosition().

QCanvasGridPattern::operator QVariant() const

Renvoie le motif de grille sous la forme d’une instance de ` QVariant`.

Éléments non membres associé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 l'pattern on fournie dans l'stream on indiquée et renvoie une référence à l'stream on.

Voir également 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 l'pattern donné à partir de l'stream spécifié et renvoie une référence à l'stream.

Voir également 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.