Exposición de QtAbstractListModel a QML
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 independientes: un proyecto QML y un proyecto Android basado en Kotlin que alojará y mostrará el contenido QML. Muestra cómo utilizar QtAbstractListModel para compartir datos desde el lado de Android con la vista QML, que muestra los datos mediante un ListView.
Ejecución del ejemplo
Para ejecutar este ejemplo, necesitas Android Studio y una instalación de Qt para Android.
El complemento Qt Gradle se utilizará para compilar el proyecto Qml durante el proceso de compilación del proyecto de Android. Para ello, el ejemplo incluye cierta configuración del complemento en el archivo build.gradle.kts a nivel de aplicación, que quizá sea necesario modificar si el complemento no encuentra, por ejemplo, el directorio del kit de Qt.
QtBuild {
// Relative for Qt (Installer or MaintenanceTool) installations.
qtPath = file("../../../../../../../6.12.0")
projectPath = file("../../qtabstractlistmodel")
}Para obtener más información sobre la configuración del complemento, consulta la documentación del complemento Qt para Gradle.
Proyecto QML
El proyecto QML es bastante sencillo: define un modelo de datos como propiedad del objeto raíz y algunos elementos de la interfaz de usuario para mostrar los datos de dicho modelo.
Rectangle {
id: mainRectangle
property AbstractItemModel dataModelPara mostrar los datos del modelo, se crea un ` ListView `. A continuación, se establece la propiedad ` model ` en el modelo de datos declarado anteriormente.
ListView {
id: listView
model: mainRectangle.dataModelPara mostrar el modelo de datos, el ` ListView ` necesita un delegado que se instanciará para cada elemento del modelo de datos. En este caso, el delegado será un ` Rectangle ` que contiene dos elementos ` Text ` en un ` Column`, mostrando los datos de cada elemento del modelo de datos.
delegate: Rectangle {
required property var model
width: listView.width
height: textColumn.height + (2 * textColumn.spacing)
color: "#2CDE85"
radius: 25
Column {
id: textColumn
height: idText.height + rowText.height + spacing
spacing: 15
anchors {
verticalCenter: parent.verticalCenter
left: parent.left
right: parent.right
leftMargin: 20
rightMargin: 20
}
Text {
id: idText
color: "#00414A"
text: model.id
font.pixelSize: 36
font.bold: true
}
Text {
id: rowText
color: "#00414A"
text: model.row
font.pixelSize: 36
font.bold: true
}
}
}Proyecto Kotlin
La parte de Android consta de una única actividad y la definición del modelo de datos utilizado anteriormente en la vista QML.
Modelo de datos
El modelo de datos MyListModel es una clase derivada de QtAbstractListModel, con ArrayList<String> como sistema de almacenamiento interno de los datos. En el bloque de inicialización de MyListModel, se generan algunos datos aleatorios para la lista.
class MyListModel : QtAbstractListModel() {
private val m_dataList = ArrayList<String>()
init {
synchronized(this) {
for (row in 0..4) {
m_dataList.add(UUID.randomUUID().toString())
}
}
}Cada elemento del modelo tiene asociado un conjunto de elementos de datos, cada uno con su propia función. Las implementaciones personalizadas de `QtAbstractItemModel` deben definir una función personalizada para cada elemento de datos. Cada función tiene asociado un valor de tipo `Int`, que se utiliza al recuperar los datos, y un valor de tipo `String`, que especifica el nombre del elemento de datos cuando se utiliza desde QML.
@Synchronized
override fun roleNames(): HashMap<Int, String> {
val m_roles = HashMap<Int, String>()
m_roles[DataRole.UUID.value()] = "id"
m_roles[DataRole.Row.value()] = "row"
return m_roles
}Aunque los valores de « Int » en el método « "roleNames()" » pueden estar codificados de forma fija, este ejemplo especifica una clase de enumeración personalizada « DataRole » dentro de « MyListModel », que se utiliza al hacer referencia a estos valores. En este ejemplo, definimos dos roles: «UUID» y «Row».
private enum class DataRole(val m_value: Int) {
UUID(0),
Row(1);
fun value(): Int {
return m_value
}
companion object {
fun valueOf(value: Int): DataRole? {
val values = entries.toTypedArray()
if (0 <= value && value < values.size) return values[value]
return null
}
}
}A la hora de devolver datos del modelo de datos, la clase debe sobrescribir el método ` "QtAbstractListModel::data()" `. Este método toma dos parámetros: `QtModelIndex` y ` Int`, que hacen referencia al índice y al rol del elemento de datos, respectivamente.
En "MyDataModel::data()", el rol UUID devuelve los datos del índice dado en los datos internos, mientras que el rol Row devuelve la fila del elemento solicitado.
Nota: Este método, junto con algunos otros, está anotado con la etiqueta @Synchronized. Esto se debe a que las llamadas a estos métodos proceden del hilo de Qt y acceden a los datos subyacentes, posiblemente al mismo tiempo que las solicitudes del hilo de Android a través de los métodos "addRow()" y "removeRow()".
@Synchronized
override fun data(qtModelIndex: QtModelIndex, role: Int): Any {
return when (DataRole.valueOf(role)) {
DataRole.UUID -> "UUID: " + m_dataList[qtModelIndex.row()]
DataRole.Row -> "Row: " + qtModelIndex.row()
else -> ""
}
}Para permitir que agentes externos manipulen el `QtAbstractItemModel`, el ejemplo añade dos métodos adicionales a ` MyDataModel`. Para añadir datos a la fila, cuenta con el método ` "addRow()" `; para eliminar datos, existe el método ` "removeRow()" `. Estos se utilizan desde la actividad principal.
@Synchronized
fun addRow() {
beginInsertRows(QtModelIndex(), m_dataList.size, m_dataList.size)
m_dataList.add(UUID.randomUUID().toString())
endInsertRows()
}
@Synchronized
fun removeRow() {
if (!m_dataList.isEmpty()) {
beginRemoveRows(QtModelIndex(), m_dataList.size - 1, m_dataList.size - 1)
m_dataList.removeAt(m_dataList.size - 1)
endRemoveRows()
}
}Actividad principal
La clase ` MainActivity ` es una sencilla actividad basada en Kotlin, pero también implementa la interfaz `QtQmlStatusChangeListener` para escuchar los eventos de estado de carga de QML. Además, almacena el objeto `QtQuickViewContent` correspondiente a la vista principal de la aplicación QML y una instancia del modelo de datos detallado anteriormente.
class MainActivity : AppCompatActivity(), QtQmlStatusChangeListener {
private val m_mainQmlContent: Main = Main()
private val m_listModel = MyListModel()Al crear la actividad principal de la aplicación, el ejemplo crea primero un QtQuickView y lo coloca en la jerarquía de vistas.
val qtQuickView: QtQuickView = QtQuickView(this)
val params: ViewGroup.LayoutParams = FrameLayout.LayoutParams(
ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT
)
val qmlFrameLayout: FrameLayout = findViewById<FrameLayout>(R.id.qmlFrame)
qmlFrameLayout.addView(qtQuickView, params)Tras añadir el QtQuickView a la interfaz de usuario, el ejemplo localiza los botones que se utilizan para manipular el modelo de datos y establece algunos escuchadores de clic para llamar a ` addRow() ` y ` removeRow() ` en el modelo de datos miembro.
val addRowAtEndButton: Button = findViewById<Button>(R.id.addRow)
val removeRowFromEndButton: Button = findViewById<Button>(R.id.removeRow)
addRowAtEndButton.setOnClickListener { _: View? ->
m_listModel.addRow()
}
removeRowFromEndButton.setOnClickListener { _: View? ->
m_listModel.removeRow()
}Una vez configurada la interfaz de usuario y establecidos los oyentes, se puede preparar y cargar el componente QML. El ejemplo establece ` MainActivity ` como oyente de la señal de cambio de estado del componente QML e indica a `QtQuickView` que cargue dicho componente.
m_mainQmlContent.setStatusChangeListener(this)
qtQuickView.loadContent(m_mainQmlContent)Por último, una vez que el componente QML se ha cargado correctamente, el ejemplo asigna el valor de la instancia de `MyDataModel` a la propiedad ` dataModel ` del componente QML.
override fun onStatusChanged(qtQmlStatus: QtQmlStatus) {
if (qtQmlStatus === QtQmlStatus.READY) {
m_mainQmlContent.setDataModel(m_listModel)
}
}© 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.