Uso de QtAbstractItemModel en proyectos de Android Studio
Qt Quick Los ejemplos de la API de Android son proyectos de Android Studio
Los ejemplos de la API « Qt Quick » para Android se proporcionan como proyectos de Android Studio. Las carpetas de los proyectos se encuentran en la ruta de instalación de Qt.
Por ejemplo, en la ruta de instalación predeterminada de Windows, se encuentran aquí:
C:\Qt\Examples\Qt-<patch-release-number>\platforms\android\<example-name>Estos proyectos ya están configurados para utilizar una versión del complemento Gradle de Qt compatible con esta versión de Qt.
Descripción general

Este ejemplo consta de dos proyectos: un proyecto de Android Studio (qtabstractitemmodel_java) y un proyecto QML (qtabstractitemmodel). Puedes importar el proyecto QML a un proyecto de Android.
El ejemplo muestra cómo gestionar tipos de datos complejos entre Java y QML. Ilustra cómo utilizar las clases de la API de Java QtAbstractItemModel y QtModelIndex. En QML, el uso de los datos se muestra con el elemento « TableView ». En Java, el uso de los datos se muestra con un modelo de elementos ArrayList anidados para las filas y las columnas. Para obtener más información sobre cómo funciona QML, consulta Qt Qml.
Ejecución del ejemplo
Para ejecutar este ejemplo, necesitas Android Studio y Qt Tools for Android Studio, además de una instalación estándar de Qt para Android. Abre qtabstractitemmodel_java en Android Studio y sigue las instrucciones de Qt Tools for Android Studio para importar el archivo « qtabstractitemmodel ».
Proyecto QML
En cuanto al proyecto QML, el ejemplo utiliza un ` Rectangle ` como objeto raíz. La variable de propiedad ` dataModel ` contiene el modelo de datos creado y proporcionado desde el lado de Java.
Rectangle {
id: mainRectangle
property AbstractItemModel dataModelTableView muestra nuestro modelo de datos.
TableView {
id: tableView
model: mainRectangle.dataModel
anchors {fill: parent; margins: 20}
columnSpacing: 4
rowSpacing: 6
boundsBehavior: TableView.OvershootBounds
clip: true
ScrollBar.vertical: ScrollBar {
policy: ScrollBar.AsNeeded
}
ScrollBar.horizontal: ScrollBar{
policy: ScrollBar.AsNeeded
}En la propiedad « delegate », cada elemento de celda del modelo se define con un « Rectangle » que contiene un « TextEdit ». La propiedad «text» del « TextEdit » se establece mediante el método « QAbstractItemModel::data()», que devuelve un valor basado en el rol y el índice proporcionados.
Al llamar a estos métodos desde Qml, la ejecución tiene lugar en el contexto del hilo «qtMainLoopThread» de Qt.
delegate: Rectangle {
implicitWidth: (tableView.height > tableView.width) ? tableView.width / 10 : tableView.height / 5
implicitHeight: implicitWidth
required property var model
color: "#2CDE85"
border {color: "#00414A"; width: 2}
TextEdit {
// Calls MyDataModel::data to get data based on the roles.
// Called in Qt qtMainLoopThread thread context.
//
// After editing is finished, call MyDataModel::setData()
// to update the value of selected cell.
onEditingFinished: parent.model.edit = text
text: parent.model.display
font {pixelSize: 26; bold: true}
padding: 5
anchors.fill: parent
wrapMode: TextEdit.Wrap
horizontalAlignment: TextEdit.AlignHCenter
verticalAlignment: TextEdit.AlignVCenter
}
}En el caso de editar el campo TextEdit, el controlador onEditingFinished() establece el valor del rol « edit » del modelo en el texto editado. Esto invoca el método QAbstractItemModel::setData(), donde el texto editado de la celda se actualiza en el índice correspondiente del modelo.
Para obtener más información, consulta QAbstractItemModel.
Proyecto de Android Studio
El proyecto de Android Studio (qtabstractitemmodel_java) contiene una clase `Activity` ( MainActivity ) y una clase ` MyDataModel `.
Modelo de datos
El modelo de datos, ` MyDataModel`, hereda de la clase `QtAbstractItemModel`. La clase ` QtAbstractItemModel ` es un envoltorio para ` QAbstractItemModel`.
Dado que los métodos de la clase MyDataModel se invocan tanto desde el lado de QML como desde el de Android, la ejecución tiene lugar en ambos contextos de hilo: el hilo qtMainLoopThread de Qt y el hilo principal de Android. Debes garantizar la sincronización al acceder a las variables de miembro en los métodos de la clase MyDataModel.
En primer lugar, el ejemplo inicializa el modelo con un conjunto de datos simulados sencillo compuesto por filas y columnas. Ten en cuenta que este método constructor se invoca en el contexto del hilo principal de Android.
/*
* Initializes the two-dimensional array list with following content:
* [] [] [] [] 1A 1B 1C 1D
* [] [] [] [] 2A 2B 2C 2D
* [] [] [] [] 3A 3B 3C 3D
* [] [] [] [] 4A 4B 4C 4D
* Threading: called in Android main thread context.
*/
public MyDataModel() {El ejemplo sobrescribe los métodos de `QtAbstractItemModel` con distintos fines. Los métodos `columnCount()` y `rowCount()` devuelven el recuento de cada uno en un modelo. La ejecución de cada `rowCount()` tiene lugar en ambos contextos de subproceso: el de Qt (`qtMainLoopThread`) y el del subproceso principal de Android.
/*
* Returns the count of columns.
* Threading: called in Android main thread context.
* Threading: called in Qt qtMainLoopThread thread context.
*/
@Override
synchronized public int columnCount(QtModelIndex qtModelIndex) {
return m_columns;
}
/*
* Returns the count of rows.
* Threading: called in Android main thread context.
* Threading: called in Qt qtMainLoopThread thread context.
*/
@Override
synchronized public int rowCount(QtModelIndex qtModelIndex) {
return m_dataList.size();
}El método data() proporciona datos del modelo basados en el rol y el índice desde Java a QML. El método roleNames() devuelve un hash que asocia los valores numéricos de los roles con sus nombres como cadenas; en QML, utilizamos estos nombres de rol para obtener los datos correspondientes del modelo. El método `index()` devuelve el nuevo índice del modelo. El método `parent()` debería devolver un padre del índice. Sin embargo, dado que este ejemplo se centra en datos sin índices padres, sobrescribimos el método y devolvemos un `QtModelIndex()` vacío. Al llamarse los métodos desde QML, la ejecución tiene lugar en el contexto del hilo `qtMainLoopThread` de Qt.
/*
* Returns the data to QML based on the roleNames
* Threading: called in Qt qtMainLoopThread thread context.
*/
@Override
synchronized public Object data(QtModelIndex qtModelIndex, int role) {
if (role == ROLE_DISPLAY) {
Cell elementForEdit = m_dataList.get(qtModelIndex.row()).get(qtModelIndex.column());
return elementForEdit.getValue();
}
Log.w(TAG, "data(): unrecognized role: " + role);
return null;
}
/*
* Defines what string i.e. role in QML side gets the data from Java side.
* Threading: called in Qt qtMainLoopThread thread context.
*/
@Override
synchronized public HashMap<Integer, String> roleNames() {
HashMap<Integer, String> roles = new HashMap<>();
roles.put(ROLE_DISPLAY, "display");
roles.put(ROLE_EDIT, "edit");
return roles;
}
/*
* Returns a new index model.
* Threading: called in Qt qtMainLoopThread thread context.
*/
@Override
synchronized public QtModelIndex index(int row, int column, QtModelIndex parent) {
return createIndex(row, column, 0);
}
/*
* Returns a parent model.
* Threading: not used called in this example.
*/
@Override
synchronized public QtModelIndex parent(QtModelIndex qtModelIndex) {
return new QtModelIndex();
}El ejemplo sobrescribe el método ` QAbstractItemModel::setData()`, que se invoca cuando los datos del modelo en ` index ` se establecen desde el lado QML de la aplicación.
/*
* Gets called when model data is edited from QML side.
* Sets the role data for the item at index to value,
* if given index is valid and if data in given index truly changed.
*/
@Override
synchronized public boolean setData(QtModelIndex index, Object value, int role) {
Cell cellAtIndex = m_dataList.get(index.row()).get(index.column());
String cellValueAtIndex = cellAtIndex.getValue();
if (!index.isValid() || role != ROLE_EDIT
|| Objects.equals(cellValueAtIndex, value.toString())) {
return false;
}
cellAtIndex.setValue(value.toString());
// Send dataChanged() when data was successfully set.
dataChanged(index, index, new int[]{role});
return true;
}El ejemplo implementa métodos en el lado del modelo para la interacción de la interfaz de usuario de « MainActivity » con el fin de añadir y eliminar filas y columnas. Se llaman métodos para iniciar, finalizar, insertar y eliminar filas con el fin de actualizar los índices del modelo, como beginInsertRow(). Dado que el ejemplo utiliza QtAbstractItemModel, debe llamar a beginInsertRows() y endInsertRows() cada vez que inserte nuevas filas en el modelo. Lo mismo se aplica a la eliminación. Dado que los métodos se invocan desde el lado de Android, la ejecución tiene lugar en el contexto del hilo principal de Android.
/*
* Adds a row.
* Threading: called in Android main thread context.
*/
synchronized public void addRow() {
if (m_columns > 0 && m_dataList.size() < MAX_ROWS_AND_COLUMNS) {
beginInsertRows(new QtModelIndex(), m_dataList.size(), m_dataList.size());
m_dataList.add(generateNewRow());
endInsertRows();
}
}
/*
* Removes a row.
* Threading: called in Android main thread context.
*/
synchronized public void removeRow() {
if (m_dataList.size() > 1) {
beginRemoveRows(new QtModelIndex(), m_dataList.size() - 1, m_dataList.size() - 1);
m_dataList.remove(m_dataList.size() - 1);
endRemoveRows();
}
}El ejemplo implementa métodos en el lado del modelo para una interacción de la interfaz de usuario de tipo « MainActivity » (dicho) para añadir y eliminar columnas. Se llaman los métodos begin, end, insert y remove para actualizar los índices del modelo, como beginRemoveColumn(). Se aplica la misma consideración del contexto que con los métodos para añadir y eliminar filas.
/*
* Adds a column.
* Threading: called in Android main thread context.
*/
synchronized public void addColumn() {
if (!m_dataList.isEmpty() && m_columns < MAX_ROWS_AND_COLUMNS) {
beginInsertColumns(new QtModelIndex(), m_columns, m_columns);
generateNewColumn();
m_columns += 1;
endInsertColumns();
}
}
/*
* Removes a column.
* Threading: called in Android main thread context.
*/
synchronized public void removeColumn() {
if (m_columns > 1) {
int columnToRemove = m_columns - 1;
beginRemoveColumns(new QtModelIndex(), columnToRemove, columnToRemove);
for (int row = 0; row < m_dataList.size(); row++)
m_dataList.get(row).remove(columnToRemove);
m_columns -= 1;
endRemoveColumns();
}
}Actividad principal
MainActivity implementa la interfaz ` QtQmlStatusChangeListener ` para recibir actualizaciones de estado cuando se carga el QML. También es la actividad principal de Android.
El ejemplo crea e inicializa el modelo de datos. Véase también QtQuickView
private final MyDataModel m_model = new MyDataModel();El ejemplo configura el botón de la interfaz de usuario y sus escuchadores para permitir a los usuarios interactuar con el modelo a través de la interfaz de usuario.
/*
* Returns the count of columns.
* Threading: called in Android main thread context.
* Threading: called in Qt qtMainLoopThread thread context.
*/
@Override
synchronized public int columnCount(QtModelIndex qtModelIndex) {
return m_columns;
}
/*
* Returns the count of rows.
* Threading: called in Android main thread context.
* Threading: called in Qt qtMainLoopThread thread context.
*/
@Override
synchronized public int rowCount(QtModelIndex qtModelIndex) {
return m_dataList.size();
}El ejemplo inicia la carga del contenido QML. La carga se realiza en segundo plano hasta que se actualiza el estado « ready ».
/*
* Returns the data to QML based on the roleNames
* Threading: called in Qt qtMainLoopThread thread context.
*/
@Override
synchronized public Object data(QtModelIndex qtModelIndex, int role) {
if (role == ROLE_DISPLAY) {
Cell elementForEdit = m_dataList.get(qtModelIndex.row()).get(qtModelIndex.column());
return elementForEdit.getValue();
}
Log.w(TAG, "data(): unrecognized role: " + role);
return null;
}
/*
* Defines what string i.e. role in QML side gets the data from Java side.
* Threading: called in Qt qtMainLoopThread thread context.
*/
@Override
synchronized public HashMap<Integer, String> roleNames() {
HashMap<Integer, String> roles = new HashMap<>();
roles.put(ROLE_DISPLAY, "display");
roles.put(ROLE_EDIT, "edit");
return roles;
}
/*
* Returns a new index model.
* Threading: called in Qt qtMainLoopThread thread context.
*/
@Override
synchronized public QtModelIndex index(int row, int column, QtModelIndex parent) {
return createIndex(row, column, 0);
}
/*
* Returns a parent model.
* Threading: not used called in this example.
*/
@Override
synchronized public QtModelIndex parent(QtModelIndex qtModelIndex) {
return new QtModelIndex();
}El ejemplo configura el modelo de datos cuando se carga el contenido QML y el estado está listo.
/*
* Gets called when model data is edited from QML side.
* Sets the role data for the item at index to value,
* if given index is valid and if data in given index truly changed.
*/
@Override
synchronized public boolean setData(QtModelIndex index, Object value, int role) {
Cell cellAtIndex = m_dataList.get(index.row()).get(index.column());
String cellValueAtIndex = cellAtIndex.getValue();
if (!index.isValid() || role != ROLE_EDIT
|| Objects.equals(cellValueAtIndex, value.toString())) {
return false;
}
cellAtIndex.setValue(value.toString());
// Send dataChanged() when data was successfully set.
dataChanged(index, index, new int[]{role});
return true;
}© 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.