En esta página

Grafo de escena: elemento pintado

Muestra cómo implementar elementos personalizados del grafo de escena basados en « QPainter ».

El ejemplo «Elemento pintado» muestra cómo utilizar el marco de trabajo de grafos de escena de QML para implementar elementos personalizados del grafo de escena mediante ` QPainter`.

Dos bocadillos verdes, alineados a la izquierda y a la derecha, con el botón «Añadir otro bocadillo»

La clase ` QQuickPaintedItem ` es una clase derivada de ` QQuickItem ` para implementar elementos personalizados del grafo de escena de QML utilizando las interfaces ` QPainter `.

El ejemplo consta de una clase de elemento y un archivo QML para utilizar dicho elemento. La clase ` TextBalloon ` representa los globos de texto individuales y hereda de ` QQuickPaintedItem `, mientras que el archivo ` textballoons.qml ` se utiliza para cargar el módulo que contiene el tipo QML `TextBalloon` y mostrar los globos de texto.

Nos centraremos primero en la clase TextBalloon y continuaremos con el archivo textballoons.qml. Para ver un ejemplo de cómo implementar un complemento para un módulo QML, consulta «Cómo escribir un complemento de extensión»

Declaración de la clase TextBalloon

La clase ` TextBalloon ` hereda de ` QQuickPaintedItem`. ` QQuickPaintedItem ` es la clase base para todos los elementos basados en ` QPainter ` en el marco de trabajo QML Scene Graph.

class TextBalloon : public QQuickPaintedItem
{
    Q_OBJECT
    Q_PROPERTY(bool rightAligned READ isRightAligned WRITE setRightAligned NOTIFY rightAlignedChanged)
    QML_ELEMENT

    public:
        TextBalloon(QQuickItem *parent = nullptr);
        void paint(QPainter *painter) override;

        bool isRightAligned() const;
        void setRightAligned(bool rightAligned);

    private:
        bool rightAligned;

    signals:
        void rightAlignedChanged();
};

Para implementar un ` QQuickPaintedItem `, debes implementar la función virtual pura ` paint()` de `QQuickPaintedItem`, que se encarga de la representación gráfica del tipo.

Definición de la clase TextBalloon

Debemos asegurarnos de inicializar la propiedad `rightAligned` para un elemento `TextBalloon`.

TextBalloon::TextBalloon(QQuickItem *parent)
    : QQuickPaintedItem(parent)
    , rightAligned(false)
{
}

A continuación, implementamos la función ` paint() `, que el marco Scene Graph invoca automáticamente para dibujar el contenido del elemento. La función dibuja el elemento en coordenadas locales.

void TextBalloon::paint(QPainter *painter)
{
    QBrush brush(QColor("#007430"));

    painter->setBrush(brush);
    painter->setPen(Qt::NoPen);
    painter->setRenderHint(QPainter::Antialiasing);

    QSizeF itemSize = size();
    painter->drawRoundedRect(0, 0, itemSize.width(), itemSize.height() - 10, 10, 10);

    if (rightAligned)
    {
        const QPointF points[3] = {
            QPointF(itemSize.width() - 10.0, itemSize.height() - 10.0),
            QPointF(itemSize.width() - 20.0, itemSize.height()),
            QPointF(itemSize.width() - 30.0, itemSize.height() - 10.0),
        };
        painter->drawConvexPolygon(points, 3);
    }
    else
    {
        const QPointF points[3] = {
            QPointF(10.0, itemSize.height() - 10.0),
            QPointF(20.0, itemSize.height()),
            QPointF(30.0, itemSize.height() - 10.0),
        };
        painter->drawConvexPolygon(points, 3);
    }
}

Comenzamos configurando el lápiz y el pincel del elemento para definir su aspecto. A continuación, empezamos a dibujar. Ten en cuenta que la función contentsBoundingRect() se invoca para dibujar en función del tamaño del elemento. El rectángulo devuelto por la función contentsBoundingRect() corresponde al tamaño del elemento tal y como se define en el archivo QML.

Archivo textballoons.qml

La interfaz consta de dos partes principales: el área desplazable con los globos de texto y el botón de controles para añadir nuevos globos.

BalloonView
ListModel {
    id: balloonModel
    ListElement {
        balloonWidth: 200
    }
    ListElement {
        balloonWidth: 120
    }
}

ListView {
    id: balloonView
    anchors.bottom: controls.top
    anchors.bottomMargin: 2
    anchors.top: parent.top
    delegate: TextBalloon {
        anchors.right: index % 2 !== 0 ? parent?.right : undefined
        height: 60
        rightAligned: index % 2 !== 0
        width: balloonWidth
    }
    model: balloonModel
    spacing: 5
    width: parent.width
}

El «balloonModel» contiene dos tipos al inicio de la aplicación, que serán mostrados por el «balloonView». El «balloonView» alterna los elementos delegados «TextBalloon» entre alineación a la izquierda y alineación a la derecha.

Controles
Rectangle {
    id: controls

    anchors.bottom: parent.bottom
    anchors.left: parent.left
    anchors.margins: 1
    anchors.right: parent.right
    border.width: 2
    color: "white"
    height: parent.height * 0.15

    Text {
        anchors.centerIn: parent
        text: qsTr("Add another balloon")
    }

    MouseArea {
        anchors.fill: parent
        hoverEnabled: true
        onClicked: {
            balloonModel.append({"balloonWidth": Math.floor(Math.random() * 200 + 100)})
            balloonView.positionViewAtIndex(balloonView.count -1, ListView.End)
        }
        onEntered: {
            parent.color = "#8ac953"
        }
        onExited: {
            parent.color = "white"
        }
    }
}

La parte de controles de la interfaz de usuario contiene un rectángulo con un « MouseArea » que cambia de color al pasar el ratón por encima. Este «botón» de control añade un nuevo objeto al final del modelo con un ancho aleatorio.

Proyecto de ejemplo en code.qt.io

© 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.