QCanvasPainterItem Class
La clase `QCanvasPainterItem` permite utilizar la API de Qt Canvas Painter en el grafo de escenas de QML. Más información...
| Encabezado: | #include <QCanvasPainterItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS CanvasPainter) target_link_libraries(mytarget PRIVATE Qt6::CanvasPainter) |
| Desde: | Qt 6.11 |
| Heredado de: | QQuickRhiItem |
Propiedades
Funciones públicas
| QCanvasPainterItem(QQuickItem *parent = nullptr) | |
| virtual | ~QCanvasPainterItem() override |
| QColor | fillColor() const |
| void | setFillColor(QColor color) |
Señales
| void | debugChanged() |
| void | fillColorChanged() |
Funciones protegidas
| virtual QCanvasPainterItemRenderer * | createItemRenderer() const = 0 |
Funciones protegidas reimplementadas
| virtual QQuickRhiItemRenderer * | createRenderer() override |
| virtual bool | event(QEvent *event) override |
Descripción detallada
Para crear tu propio elemento de pintura, primero debes crear una subclase de `QCanvasPainterItem` y, a continuación, empezar por implementar su única función pública virtual pura: ` createItemRenderer()`, que devuelve un objeto que realiza la pintura propiamente dicha.
El siguiente fragmento de código muestra la estructura típica de una subclase de QCanvasPainterItem. Consulte QCanvasPainterItemRenderer para ver un ejemplo de la clase MyRenderer.
class MyItem : public QCanvasPainterItem
{
Q_OBJECT
QML_NAMED_ELEMENT(MyItem) // exposed to QML, instantiate as MyItem { ... }
// a custom property
Q_PROPERTY(float value READ value WRITE setValue NOTIFY valueChanged)
public:
MyItem(QQuickItem *parent = nullptr)
: QCanvasPainterItem(parent)
{
}
QCanvasPainterItemRenderer *createItemRenderer() const override
{
return new MyRenderer;
}
float value() const { return m_value; }
void setValue(float newValue)
{
if (m_value != newValue) {
m_value = newValue;
emit valueChanged();
}
}
signals:
void valueChanged();
private:
float m_value = 0.0f;
};Mediante la propiedad ` QtQuick::Item::antialiasing `, es posible desactivar el suavizado. El valor por defecto es ` true`. Cuando se establece en ` false`, se desactiva el suavizado incluso si el código de dibujo llama a ` QCanvasPainter::setAntialias()` con un valor mayor que ` 0`. Desactivar el suavizado puede aumentar el rendimiento.
Véase también QCanvasPainterItemRenderer.
Documentación de propiedades
[read-only] debug : QVariantMap
Contiene una tabla clave-valor con estadísticas de representación. Los datos solo se recopilan cuando la variable de entorno ` QCPAINTER_DEBUG_COLLECT ` está establecida en un valor distinto de cero.
Los datos se actualizan periódicamente, no cada vez que se vuelve a dibujar el elemento. El intervalo es actualmente de un segundo. Por lo tanto, los datos recibidos se referirán, en muchos casos, a un dibujo anterior del elemento. Esto no suele suponer un problema cuando se muestran las estadísticas de forma interactiva, pero es importante tenerlo en cuenta.
Para mostrar automáticamente los datos dentro del elemento en forma de superposición, configura en su lugar la variable de entorno QCPAINTER_DEBUG_RENDER. Esto proporciona un atajo práctico cuando la intención es, de todos modos, mostrar los valores en pantalla.
La lista de claves es actualmente la siguiente:
- fillDrawCallCount
- strokeDrawCallCount
- textDrawCallCount
- fillTriangleCount
- strokeTriangleCount
- textTriangleCount
- recuento de llamadas de dibujo
- recuento de triángulos
- usoDeMemoriaParaImágenes
- recuento de imágenes
- recuento de grupos de rutas
- recuento de subrutas almacenadas en caché
- tamaño de los datos de vértices de la ruta almacenados en caché
Señal del notificador:
| void | debugChanged() |
fillColor : QColor
Esta propiedad determina el color que se utilizará para rellenar el elemento, es decir, el fondo del mismo.
El color predeterminado es el negro.
Funciones de acceso:
| QColor | fillColor() const |
| void | setFillColor(QColor color) |
Señal de notificador:
| void | fillColorChanged() |
Documentación de las funciones de miembro
[explicit] QCanvasPainterItem::QCanvasPainterItem(QQuickItem *parent = nullptr)
Crea un objeto `QCanvasPainterItem` con el elemento ` parent ` indicado.
[override virtual noexcept] QCanvasPainterItem::~QCanvasPainterItem()
Destruye la « QCanvasPainterItem ».
[pure virtual protected] QCanvasPainterItemRenderer *QCanvasPainterItem::createItemRenderer() const
Implementa este método para (re)crear un «painter» para este elemento. La clase «painter» debe heredar de QCanvasPainterItemRenderer. QCanvasPainterItem asume la propiedad del objeto creado y lo elimina cuando sea necesario.
Código de ejemplo:
QCanvasPainterItemRenderer* MyItem::createItemRenderer() const { return new MyItemPainter(); }
[override virtual protected] QQuickRhiItemRenderer *QCanvasPainterItem::createRenderer()
Reimplementa: ` QQuickRhiItem::createRenderer()`.
[override virtual protected] bool QCanvasPainterItem::event(QEvent *event)
Reimplementa: ` QQuickRhiItem::event(QEvent *e)`.
QColor QCanvasPainterItem::fillColor() const
Devuelve el color de relleno actual.
Nota: Funcióngetter para la propiedad fillColor.
Véase también setFillColor().
void QCanvasPainterItem::setFillColor(QColor color)
Establece el color de relleno en color. Este color se utilizará para dibujar el fondo del elemento. El color por defecto es el negro.
Nota: Al establecer el color de relleno para que no sea totalmente opaco (canal alfa inferior a 255), recuerda establecer también « alphaBlending » en « true ».
Nota: Funciónde asignación para la propiedad fillColor.
Véase también fillColor() y QQuickRhiItem::alphaBlending.
© 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.