En esta página

QCanvasGridPattern Class

QCanvasGridPattern es un pincel para dibujar patrones de cuadrícula. Más información...

Encabezado: #include <QCanvasGridPattern>
CMake: find_package(Qt6 REQUIRED COMPONENTS CanvasPainter)
target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter)
Desde: Qt 6.11

Funciones públicas

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)

Descripción detallada

QCanvasGridPattern es un pincel para dibujar patrones de cuadrícula y barras.

A continuación se muestra un ejemplo sencillo:

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

Cuadrado redondeado, relleno con una rejilla diagonal amarilla y bordeado por un trazo discontinuo blanco

Documentación de las funciones de miembro

QCanvasGridPattern::QCanvasGridPattern(QPointF startPosition, QSizeF cellSize)

Crea un patrón de cuadrícula que comienza en startPosition, con una celda única de tamaño cellSize.

Véase también setStartPosition() y setCellSize().

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

Crea un patrón de cuadrícula que comienza en startX y startY, con celdas de un solo tamaño: cellWidth y cellHeight.

Véase también setLineColor(), setBackgroundColor(), setLineWidth(), setFeather() y setRotation().

QCanvasGridPattern::QCanvasGridPattern(const QCanvasGridPattern &)

Elimina el patrón de cuadrícula.

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

Crea una instancia de ` QCanvasGridPattern` mediante la construcción por movimiento.

QColor QCanvasGridPattern::backgroundColor() const

Devuelve el color de fondo de la cuadrícula del patrón.

Véase también setBackgroundColor().

QSizeF QCanvasGridPattern::cellSize() const

Devuelve el tamaño de una sola celda en un patrón de cuadrícula.

Véase también setCellSize().

qreal QCanvasGridPattern::feather() const

Devuelve el patrón «feather» en píxeles.

Véase también setFeather().

QColor QCanvasGridPattern::lineColor() const

Devuelve el color de las líneas de la cuadrícula del patrón.

Véase también setLineColor().

qreal QCanvasGridPattern::lineWidth() const

Devuelve el ancho de una línea de trazo en un patrón de cuadrícula.

Véase también setLineWidth().

qreal QCanvasGridPattern::rotation() const

Devuelve la rotación del patrón en radianes.

Véase también setRotation().

void QCanvasGridPattern::setBackgroundColor(QColor color)

Establece el color de fondo de la cuadrícula de patrones en color. El valor por defecto es el negro.

Véase también backgroundColor().

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

Establece el tamaño de una celda individual en un patrón de cuadrícula en width, height. Cuando el ancho es 0, no se dibujan las barras horizontales. Cuando la altura es 0, no se dibujan las barras verticales. El valor por defecto es (10, 10).

Véase también cellSize().

void QCanvasGridPattern::setCellSize(QSizeF size)

Establece el tamaño de una celda individual en un patrón de cuadrícula en size. Cuando el ancho es 0, no se dibujan las barras horizontales. Cuando la altura es 0, no se dibujan las barras verticales. El valor por defecto es (10, 10).

Se trata de una función sobrecargada.

void QCanvasGridPattern::setFeather(qreal feather)

Establece el desenfoque del patrón en feather en píxeles. El valor por defecto es 1.0, lo que significa un suavizado de un solo píxel.

Véase también feather().

void QCanvasGridPattern::setLineColor(QColor color)

Establece el color de las líneas de la cuadrícula del patrón en color. El valor por defecto es el blanco.

Véase también lineColor().

void QCanvasGridPattern::setLineWidth(qreal width)

Establece el ancho de una línea de trazo en un patrón de cuadrícula en width. El valor por defecto es 1.0.

Véase también lineWidth().

void QCanvasGridPattern::setRotation(qreal rotation)

Establece la rotación del patrón en rotation en radianes. La rotación se realiza alrededor de la cuadrícula startPosition(). El valor por defecto es 0.0, lo que significa que la cuadrícula no se gira.

Véase también rotation().

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

Establece el punto de inicio del patrón de cuadrícula en (x, y). La posición inicial se refiere a la esquina superior izquierda de la cuadrícula en el patrón. A partir de ahí, el patrón se extenderá a todas las posiciones. El valor por defecto es (0.0, 0.0).

Véase también startPosition().

void QCanvasGridPattern::setStartPosition(QPointF point)

Establece el punto de inicio del patrón de cuadrícula en point. La posición inicial corresponde a la esquina superior izquierda de la cuadrícula en el patrón. A partir de ahí, el patrón se extenderá a todas las posiciones. El valor por defecto es (0.0, 0.0).

Se trata de una función sobrecargada.

QPointF QCanvasGridPattern::startPosition() const

Devuelve el punto inicial del patrón de cuadrícula.

Véase también setStartPosition().

QCanvasGridPattern::operator QVariant() const

Devuelve el patrón de cuadrícula como un objeto ` QVariant`.

Elementos no miembros relacionados

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

Devuelve « true » si el patrón de cuadrícula « lhs » es diferente de « rhs »; en caso contrario, devuelve « false ».

Véase también operator==().

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

Escribe el objeto ` pattern ` especificado en el objeto ` stream ` especificado y devuelve una referencia al objeto ` stream`.

Véase también «Serialización detipos de datos de Qt».

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

Devuelve « true » si el patrón de cuadrícula « lhs » es igual a « rhs »; en caso contrario, devuelve « false ».

Véase también operator!=().

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

Lee el objeto ` pattern ` especificado a partir del objeto ` stream ` especificado y devuelve una referencia al objeto ` stream`.

Véase también «Serialización detipos de datos de 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.