Qt Quick Controles
Qt Quick La sección «Controles» ofrece un conjunto de controles que se pueden utilizar para crear interfaces completas en Qt Quick.

Qt Quick «Controles» incluye una selección de estilos personalizables. Consulta «Estilos de los controles de Qt Quick » para obtener más detalles.
Uso del módulo
API de QML
Los tipos QML del módulo están disponibles a través de la importación « QtQuick.Controls ». Para utilizar los tipos, añade la siguiente instrucción de importación a tu archivo .qml:
import QtQuick.ControlsAPI de C++
Para utilizar la API de C++ de un módulo de Qt es necesario vincularla con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación ofrecen soporte específico para ello, entre ellas CMake y qmake.
Compilación con CMake
Utiliza el comando « find_package() » para localizar el componente del módulo necesario en el paquete « Qt6 »:
find_package(Qt6 REQUIRED COMPONENTS QuickControls2)
target_link_libraries(mytarget PRIVATE Qt6::QuickControls2)Para obtener más detalles, consulta la descripción general de «Compilación con CMake ».
Compilación con qmake
Para configurar el módulo para la compilación con qmake, añada el módulo como valor de la variable ` QT ` en el archivo `.pro` del proyecto:
QT += quickcontrols2Compilación a partir del código fuente
Se Qt Image Formats módulo es recomendable, pero no obligatorio. Ofrece compatibilidad con el formato « .webp » utilizado por el estilo «Imagine».
Controles
Para ver la lista completa de controles de « Qt Quick », consulta QML Types.
Controles de botón
Tipo base abstracto que proporciona la funcionalidad común a los botones | |
Botón pulsador en el que se puede hacer clic para ejecutar un comando o responder a una pregunta | |
Botón de selección que se puede activar o desactivar | |
Botón de selección que se activa al mantenerlo pulsado el tiempo suficiente | |
Botón de opción exclusivo que se puede activar o desactivar | |
Un control de botón con esquinas redondeadas en el que el usuario puede hacer clic | |
Botón que se puede activar o desactivar | |
Botón con un aspecto adecuado para una barra de herramientas |
Controles contenedores
Ventana de nivel superior con estilo y compatibilidad con encabezado y pie de página | |
Tipo base abstracto que proporciona la funcionalidad común a los contenedores | |
Marco visual para un grupo lógico de controles | |
Marco visual y título para un grupo lógico de controles | |
Proporciona una vista de cabecera horizontal para acompañar a una TableView | |
Control de página con estilo y compatibilidad con encabezado y pie de página | |
Proporciona un fondo que se adapta al estilo y al tema de la aplicación | |
Vista desplazable | |
Dispone los elementos con un separador arrastrable entre cada uno de ellos | |
Ofrece un modelo de navegación basado en pilas | |
Permite al usuario navegar por las páginas deslizando el dedo lateralmente | |
Permite al usuario cambiar entre diferentes vistas o subtareas | |
Contenedor para controles sensibles al contexto | |
Ofrece una vista de encabezado vertical para acompañar a una TableView |
Controles delegados
Delegado de elemento con un indicador de selección que se puede activar o desactivar | |
Delegado de elemento básico que se puede utilizar en diversas vistas y controles | |
Delegado de elemento exclusivo con un indicador de radio que se puede activar o desactivar | |
Delegado de elemento deslizable | |
Delegado de elemento con un indicador de interruptor que se puede activar o desactivar | |
Un delegado que se puede asignar a un TableView | |
Un delegado que se puede asignar a un TreeView | |
Controles indicadores
Indica actividad en segundo plano, por ejemplo, mientras se carga el contenido | |
Indica la página activa en ese momento | |
Indica el progreso de una operación | |
Barra de desplazamiento interactiva vertical u horizontal | |
Indicador de desplazamiento vertical u horizontal no interactivo |
Controles de entrada
Botón combinado con lista desplegable para seleccionar opciones | |
Dial circular que se gira para establecer un valor | |
Permite al usuario seleccionar entre un conjunto de valores de punto flotante predefinidos | |
Se utiliza para seleccionar un rango de valores deslizando dos controles a lo largo de una pista | |
Campo de entrada especializado diseñado para la función de búsqueda | |
Se utiliza para seleccionar un valor deslizando un controlador a lo largo de una pista | |
Permite al usuario seleccionar entre un conjunto de valores preestablecidos | |
Área de introducción de texto de varias líneas | |
Campo de entrada de texto de una sola línea | |
Rueda giratoria con elementos que se pueden seleccionar |
Controles de menú
El tipo «adjunto» permite abrir un menú contextual de forma adecuada a la plataforma | |
Ventana emergente que puede utilizarse como menú contextual o menú emergente | |
Proporciona una barra de menús de ventana | |
Muestra un menú desplegable dentro de una barra de menús | |
Muestra un elemento dentro de un menú |
Controles de navegación
Panel lateral que se puede abrir y cerrar con un gesto de deslizamiento | |
Ofrece un modelo de navegación basado en pilas | |
Permite al usuario navegar por las páginas deslizando el dedo lateralmente | |
Permite al usuario cambiar entre diferentes vistas o subtareas | |
Botón con un aspecto adecuado para una barra de pestañas |
Controles emergentes
Cuadro de diálogo emergente con botones estándar y un título, utilizado para la interacción a corto plazo con el usuario | |
Panel lateral que se puede abrir y cerrar con un gesto de deslizamiento | |
Ventana emergente que puede utilizarse como menú contextual o menú emergente | |
Tipo básico de controles de interfaz de usuario tipo ventana emergente | |
Proporciona información sobre herramientas para cualquier control |
Controles separadores
Separa un grupo de elementos de un menú de los elementos adyacentes | |
Separa un grupo de elementos de una barra de herramientas de los elementos adyacentes |
Evolución de los módulos
Qt Quick Controls se diseñó originalmente centrándose principalmente en las interfaces táctiles. Aunque ya es posible desarrollar interfaces de escritorio, se sigue trabajando para ofrecer una apariencia y un comportamiento más nativos.
La sección«Cambios en los controles Qt Quick » enumera los cambios importantes en la API y la funcionalidad del módulo que se han realizado para la serie Qt 6 de Qt.
El esquema de versiones describe el esquema de versiones utilizado para « Qt Quick Controls».
Artículos y guías
- Primeros pasos
- Directrices
- Estilo
- Iconos
- Personalización
- Uso de selectores de archivos
- Implementación
- Archivo de configuración
- Variables de entorno
Ejemplos
- Galería
- Tutorial de chat
- Editor de texto
- Demostración de dispositivos wearables
- Ejemplo del sector de la automoción
- Todos los ejemplos
Referencia
Módulos relacionados
Licencia y atribuciones
Qt Quick Controls está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulta «Licencias de Qt» para obtener más detalles.
Por otra parte, « Qt Quick » Controls puede contener módulos de terceros bajo las siguientes licencias permisivas:
Licencia MIT |
© 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.