En esta página

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.

Galería de controles al estilo Basic

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.Controls

API 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 += quickcontrols2

Compilació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

AbstractButton

Tipo base abstracto que proporciona la funcionalidad común a los botones

Button

Botón pulsador en el que se puede hacer clic para ejecutar un comando o responder a una pregunta

CheckBox

Botón de selección que se puede activar o desactivar

DelayButton

Botón de selección que se activa al mantenerlo pulsado el tiempo suficiente

RadioButton

Botón de opción exclusivo que se puede activar o desactivar

RoundButton

Un control de botón con esquinas redondeadas en el que el usuario puede hacer clic

Switch

Botón que se puede activar o desactivar

ToolButton

Botón con un aspecto adecuado para una barra de herramientas

Controles contenedores

ApplicationWindow

Ventana de nivel superior con estilo y compatibilidad con encabezado y pie de página

Container

Tipo base abstracto que proporciona la funcionalidad común a los contenedores

Frame

Marco visual para un grupo lógico de controles

GroupBox

Marco visual y título para un grupo lógico de controles

HorizontalHeaderView

Proporciona una vista de cabecera horizontal para acompañar a una TableView

Page

Control de página con estilo y compatibilidad con encabezado y pie de página

Pane

Proporciona un fondo que se adapta al estilo y al tema de la aplicación

ScrollView

Vista desplazable

SplitView

Dispone los elementos con un separador arrastrable entre cada uno de ellos

StackView

Ofrece un modelo de navegación basado en pilas

SwipeView

Permite al usuario navegar por las páginas deslizando el dedo lateralmente

TabBar

Permite al usuario cambiar entre diferentes vistas o subtareas

ToolBar

Contenedor para controles sensibles al contexto

VerticalHeaderView

Ofrece una vista de encabezado vertical para acompañar a una TableView

Controles delegados

CheckDelegate

Delegado de elemento con un indicador de selección que se puede activar o desactivar

HorizontalHeaderViewDelegate

ItemDelegate

Delegado de elemento básico que se puede utilizar en diversas vistas y controles

RadioDelegate

Delegado de elemento exclusivo con un indicador de radio que se puede activar o desactivar

SwipeDelegate

Delegado de elemento deslizable

SwitchDelegate

Delegado de elemento con un indicador de interruptor que se puede activar o desactivar

TableViewDelegate

Un delegado que se puede asignar a un TableView

TreeViewDelegate

Un delegado que se puede asignar a un TreeView

VerticalHeaderViewDelegate

Controles indicadores

BusyIndicator

Indica actividad en segundo plano, por ejemplo, mientras se carga el contenido

PageIndicator

Indica la página activa en ese momento

ProgressBar

Indica el progreso de una operación

ScrollBar

Barra de desplazamiento interactiva vertical u horizontal

ScrollIndicator

Indicador de desplazamiento vertical u horizontal no interactivo

Controles de entrada

ComboBox

Botón combinado con lista desplegable para seleccionar opciones

Dial

Dial circular que se gira para establecer un valor

DoubleSpinBox

Permite al usuario seleccionar entre un conjunto de valores de punto flotante predefinidos

RangeSlider

Se utiliza para seleccionar un rango de valores deslizando dos controles a lo largo de una pista

SearchField

Campo de entrada especializado diseñado para la función de búsqueda

Slider

Se utiliza para seleccionar un valor deslizando un controlador a lo largo de una pista

SpinBox

Permite al usuario seleccionar entre un conjunto de valores preestablecidos

TextArea

Área de introducción de texto de varias líneas

TextField

Campo de entrada de texto de una sola línea

Tumbler

Rueda giratoria con elementos que se pueden seleccionar

ContextMenu

El tipo «adjunto» permite abrir un menú contextual de forma adecuada a la plataforma

Menu

Ventana emergente que puede utilizarse como menú contextual o menú emergente

MenuBar

Proporciona una barra de menús de ventana

MenuBarItem

Muestra un menú desplegable dentro de una barra de menús

MenuItem

Muestra un elemento dentro de un menú

Drawer

Panel lateral que se puede abrir y cerrar con un gesto de deslizamiento

StackView

Ofrece un modelo de navegación basado en pilas

SwipeView

Permite al usuario navegar por las páginas deslizando el dedo lateralmente

TabBar

Permite al usuario cambiar entre diferentes vistas o subtareas

TabButton

Botón con un aspecto adecuado para una barra de pestañas

Dialog

Cuadro de diálogo emergente con botones estándar y un título, utilizado para la interacción a corto plazo con el usuario

Drawer

Panel lateral que se puede abrir y cerrar con un gesto de deslizamiento

Menu

Ventana emergente que puede utilizarse como menú contextual o menú emergente

Popup

Tipo básico de controles de interfaz de usuario tipo ventana emergente

ToolTip

Proporciona información sobre herramientas para cualquier control

Controles separadores

MenuSeparator

Separa un grupo de elementos de un menú de los elementos adyacentes

ToolSeparator

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

Ejemplos

Referencia

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:

© 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.