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.
![]()
Ejecución del ejemplo
Puedes ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde « Command Palette » y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
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: sizeCada 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: radiusDentro 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.
© 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.