En esta página

Qt Quick Controles - Lista de contactos

Una aplicación QML que utiliza los controles de Qt Quick y una clase C++ que implementa una lista de contactos sencilla.

El ejemplo de la lista de contactos muestra cómo integrar un backend en C++ de forma compatible con el Diseñador de Qt Quick. Para las partes declarativas de la interfaz de usuario, se utilizan archivos .ui.qml que se pueden editar visualmente en el Diseñador de Qt Quick.

Aplicación de agenda de contactos que muestra nombres y direcciones

Backend en C++

La aplicación de lista de contactos permite al usuario añadir, editar y eliminar contactos. La implementación real se realiza en C++ y se expone como un QAbstractListModel.

La clase ContactModel de C++ se registra en un espacio de nombres y, posteriormente, MainForm.ui.qml la importa y crea una instancia de la misma. Para obtener más información sobre cómo registrar clases de C++ como tipos QML, consulta Definición de tipos QML desde C++.

#include <QtQml/qqml.h>
...
qmlRegisterType<ContactModel>("Backend", 1, 0, "ContactModel");
...

Compatibilidad con el diseñador

En el subdirectorio «designer», creamos un complemento que sustituye a ContactModel en Qt Quick Designer. Para que esto funcione, añadimos la siguiente línea a contactlist.pro.

QML_DESIGNER_IMPORT_PATH = $$PWD/designer

Dado que el Diseñad Qt Quick e no puede instanciar la clase C++ ContactModel, definimos una simulación utilizando un ListModel. Esto garantiza que el ListView que utiliza el modelo muestre algo en el Diseñad Qt Quick e.

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

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.