En esta página

QCanvasGridPattern Class

QCanvasGridPattern es un pincel para pintar patrones de cuadrícula. Más...

Cabecera: #include <QCanvasGridPattern>
CMake: find_package(Qt6 REQUIRED COMPONENTS CanvasPainter)
target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter)
Desde: Qt 6.11
Hereda de: QCanvasBrush
Estado: Technical Preview

Funciones públicas

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)

Descripción Detallada

QCanvasGridPattern es un pincel para pintar patrones de cuadrículas y barras.

Aquí hay un ejemplo 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();

Documentación de Funciones Miembro

QCanvasGridPattern::QCanvasGridPattern()

Construye un patrón de cuadrícula por defecto. La posición de inicio del patrón es (0, 0) y el tamaño del patrón (100, 100). El ángulo del patrón es 0.0, el color de la línea de la cuadrícula es blanco y el color de fondo es negro.

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)

Construye un patrón de cuadrícula. La posición de inicio y el tamaño del patrón se definen con rect. El color de la línea de la cuadrícula es lineColor y el color de fondo es backgroundColor. El ancho de la línea de la cuadrícula es lineWidth, la pluma (antialiasing) es feather y el ángulo es 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)

Construye un patrón de cuadrícula. La posición de inicio del patrón es ( x, y) y el tamaño del patrón ( width, height). El color de la línea de la cuadrícula es lineColor y el color de fondo es backgroundColor. El ángulo del patrón es angle.

[noexcept] QCanvasGridPattern::~QCanvasGridPattern()

Destruye el patrón de cuadrícula.

QColor QCanvasGridPattern::backgroundColor() const

Devuelve el color de fondo de la rejilla del patrón.

Véase también setBackgroundColor().

QSizeF QCanvasGridPattern::cellSize() const

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

Véase también setCellSize().

float QCanvasGridPattern::feather() const

Devuelve la pluma del patrón en píxeles.

Véase también setFeather().

QColor QCanvasGridPattern::lineColor() const

Devuelve el color de la línea de la rejilla del patrón.

Véase también setLineColor().

float QCanvasGridPattern::lineWidth() const

Devuelve la anchura de una línea de trazo en el patrón de cuadrícula.

Véase también setLineWidth().

float QCanvasGridPattern::rotation() const

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

Véase también setRotation().

void QCanvasGridPattern::setBackgroundColor(const QColor &color)

Establece el color de fondo de la rejilla del patrón en color. El valor por defecto es negro.

Véase también backgroundColor().

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

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

Véase también cellSize().

void QCanvasGridPattern::setCellSize(QSizeF size)

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

Se trata de una función sobrecargada.

void QCanvasGridPattern::setFeather(float feather)

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

Véase también feather().

void QCanvasGridPattern::setLineColor(const QColor &color)

Establece el color de la línea de la rejilla del patrón en color. El valor por defecto es blanco.

Véase también lineColor().

void QCanvasGridPattern::setLineWidth(float width)

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

Véase también lineWidth().

void QCanvasGridPattern::setRotation(float rotation)

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

Véase también rotation().

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

Establece el punto de inicio de la cuadrícula en (x, y). La posición inicial significa la esquina superior izquierda de la cuadrícula en el patrón. El patrón se extenderá a todas las posiciones a partir de aquí. 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 de inicio significa la esquina superior izquierda de la cuadrícula en el patrón. El patrón se extenderá a todas las posiciones a partir de aquí. El valor por defecto es (0.0, 0.0).

Se trata de una función sobrecargada.

QPointF QCanvasGridPattern::startPosition() const

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

Véase también setStartPosition().

QCanvasGridPattern::operator QVariant() const

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

Relacionados No miembros

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

Devuelve true si el patrón de rejilla lhs es diferente de rhs; false en caso contrario.

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

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

Escribe el pattern dado en el stream dado y devuelve una referencia al stream.

Véase también Serializar tipos de datos Qt.

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

Devuelve true si el patrón de rejilla lhs es igual a rhs; false en caso contrario.

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

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

Lee el pattern dado del stream dado y devuelve una referencia al stream.

Véase también Serializar tipos de datos 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.