En esta página

Qt Quick Ejemplos de TableViews: Pixelator

El ejemplo de Pixelator muestra cómo se pueden utilizar un « TableView » de QML y un delegado para crear modelos de tabla personalizados.

El logotipo de Qt se muestra como un patrón de puntos utilizando TableView, con el tamaño de los puntos basado en los valores de gris de los píxeles.

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

class ImageModel : public QAbstractTableModel
{
    Q_OBJECT
    Q_PROPERTY(QString source READ source WRITE setSource NOTIFY sourceChanged)
    QML_ELEMENT
public:
    ImageModel(QObject *parent = nullptr);

    QString source() const;
    void setSource(const QString &source);

    int rowCount(const QModelIndex &parent = QModelIndex()) const override;
    int columnCount(const QModelIndex &parent = QModelIndex()) const override;

    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;

    QVariant headerData(int /* section */, Qt::Orientation /* orientation */,
                        int role) const override;

signals:
    void sourceChanged();

private:
    QString m_source;
    QImage m_image;
};

Solo necesitamos un modelo de tabla sencillo y de solo lectura. Por lo tanto, debemos implementar funciones para indicar las dimensiones de la imagen y proporcionar datos a ` TableView`. Utilizamos el sistema de propiedades de Qt y una propiedad de origen como ` QString ` para establecer la ruta de la imagen. También añadimos la macro ` QML_ELEMENT ` para exponer el modelo a QML.

void ImageModel::setSource(const QString &source)
{
    if (m_source == source)
        return;

    beginResetModel();
    m_source = source;
    m_image.load(m_source);
    endResetModel();
}

Aquí cargamos la imagen cuando se establece la ruta de origen. Cuando la ruta de origen ha cambiado, debemos llamar primero a ` beginResetModel() `. Una vez cargada la imagen, debemos llamar a ` endResetModel()`.

int ImageModel::rowCount(const QModelIndex &parent) const
{
    if (parent.isValid())
        return 0;
    return m_image.height();
}

int ImageModel::columnCount(const QModelIndex &parent) const
{
    if (parent.isValid())
        return 0;
    return m_image.width();
}

El número de filas y columnas se establece en la altura y la anchura de la imagen, respectivamente.

QVariant ImageModel::data(const QModelIndex &index, int role) const
{
    if (!index.isValid() || role != Qt::DisplayRole)
        return QVariant();
    return qGray(m_image.pixel(index.column(), index.row()));
}

Esta función sobrecargada nos permite acceder a los datos de píxeles de la imagen. Cuando llamamos a esta función con el rol «display», devolvemos el valor de gris del píxel.

Component {
    id: pixelDelegate

    Item {
        required property real display

        readonly property real gray: display / 255.0
        readonly property real size: 16

        implicitWidth: size
        implicitHeight: size

Cada píxel de ` TableView ` se muestra a través de un componente delegado. Este contiene un elemento que tiene una altura y una anchura implícitas que definen el tamaño de las celdas de la tabla. También cuenta con una propiedad para el valor de gris del píxel que se recupera del modelo.

Rectangle {
    id: rect
    anchors.centerIn: parent
    color: "#09102b"
    radius: parent.size - parent.gray * parent.size
    implicitWidth: radius
    implicitHeight: radius

Dentro de la ` Item`, hay un ` Rectangle ` redondeado cuyo tamaño y radio se ajustan al valor de gris del píxel.

MouseArea {
    anchors.fill: parent
    hoverEnabled: true
    onEntered: rect.color = "#cecfd5"
    onExited: colorAnimation.start()
}

Para añadir un poco de interacción, colocamos un MouseArea dentro del Item y cambiamos el color del rectángulo al pasar el ratón por encima.

ColorAnimation on color {
    id: colorAnimation
    running: false
    to: "#41cd52"
    duration: 1500
}

El Rectangle también cuenta con una breve animación de color para realizar una transición gradual entre los colores cuando se cambia.

TableView {
    id: tableView
    anchors.fill: parent
    model: ImageModel {
        source: ":/qt.png"
    }

    delegate: pixelDelegate
}

El « TableView » abarca toda la ventana y tiene adjunta una instancia de nuestro « ImageModel » personalizado.

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.