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 |
Elementos no miembros relacionados
| 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();
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.