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.

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/designerDado 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:
- 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.
© 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.