En esta página

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

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.