Qt Quick Controles: estilo plano
Una aplicación QML que utiliza los controles de « Qt Quick » y módulos QML con controles personalizados.
El estiloplano muestra cómo integrar controles personalizados en el Diseñador de « Qt Quick ». El ejemplo utiliza un módulo QML puro para definir constantes en un singleton. Para las partes declarativas de la interfaz de usuario, se utilizan archivos « .ui.qml ». Estos se pueden editar visualmente en el Diseñador de « Qt Quick ».

Módulo QML para la personalización de temas
El ejemplo contiene un módulo QML denominado Theme, que consiste en un singleton QML con el mismo nombre. Para garantizar que QML encuentre el módulo, añadimos el directorio de importación a las rutas de importación del motor en main.cpp.
...
engine.addImportPath(":/imports");
...Para garantizar que el modelo de código y el diseñador de Qt Quick puedan encontrar el módulo, añadimos la siguiente línea a flatstyle.pro.
QML_IMPORT_PATH = $$PWD/importsTodos los colores, parámetros de fuente y constantes de tamaño que se utilizan en este ejemplo se definen como propiedades en el singleton denominado Theme.qml. Normalmente, estos valores de atributos se definen como constantes, ya que no se espera que cambien en tiempo de ejecución. En este ejemplo, permitimos al usuario cambiar algunos atributos, como el color principal, el parámetro de tamaño y algunos parámetros de fuente, mientras la aplicación está en ejecución.
Definir estos valores de atributos en un singleton facilita su mantenimiento y modificación. Este patrón simplifica la implementación de temas.
Módulo QML para controles personalizados
El módulo Flat contiene un estilo para varios controles que implementan una apariencia personalizada. Este estilo se establece como el estilo de la aplicación en qtquickcontrols2.conf.
El ejemplo utiliza los estados de un elemento ` Qt Quick ` para implementar los diferentes estados de un control. Esto tiene la ventaja de que podemos definir el aspecto personalizado en Qt Quick Designer y podemos verificar fácilmente los diferentes estados de un control. Para editar el indicador de un interruptor en el Diseñador de Qt Quick, podemos abrir Switch.qml y, a continuación, introducir la implementación del indicador denominado « switchHandle » utilizando el cuadro combinado situado en la parte superior, junto al cuadro combinado de los documentos abiertos.

La aplicación en sí es simplemente un formulario sencillo que permite al usuario ajustar un par de parámetros de los controles personalizados. El usuario puede elegir otro color principal, configurar la fuente en negrita o subrayada y aumentar el tamaño de los controles activando o desactivando un interruptor.
MainForm.ui.qml es simplemente la definición declarativa pura del formulario, mientras que flatstyle.qml instancia el formulario e implementa la lógica.
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.