En esta página

Qt Quick Controls QML Types

Qt Quick «Controls» proporciona tipos QML para crear interfaces de usuario. Estos tipos QML funcionan en combinación con Qt Quicklos diseños «Qt Quick ».

Qt Quick Los tipos QML de «Controls» se pueden importar a tu aplicación utilizando la siguiente instrucción de importación en tu archivo .qml:

import QtQuick.Controls

Tipos QML

AbstractButton

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

Action

Acción abstracta de interfaz de usuario

ActionGroup

Agrupa acciones

ApplicationWindow

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

BusyIndicator

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

Button

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

ButtonGroup

Grupo de botones de selección mutuamente excluyentes

Calendar

Un espacio de nombres de calendario

CalendarModel

Un modelo de calendario

CheckBox

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

CheckDelegate

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

ComboBox

Botón combinado con lista emergente para seleccionar opciones

Container

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

ContextMenu

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

Control

Tipo base abstracto que proporciona funcionalidad común a todos los controles

DayOfWeekRow

Una fila con los nombres de los días de la semana

DelayButton

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

Dial

Dial circular que se gira para establecer un valor

Dialog

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

DialogButtonBox

Un cuadro de botones utilizado en los cuadros de diálogo

DoubleSpinBox

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

Drawer

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

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 encabezado horizontal para acompañar a un TableView

HorizontalHeaderViewDelegate

ItemDelegate

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

Label

Etiqueta de texto con estilo y fuente heredada

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ú

MenuSeparator

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

MonthGrid

Una cuadrícula de días para un mes del calendario

Overlay

Una superposición de ventana para ventanas emergentes

Page

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

PageIndicator

Indica la página actualmente activa

Pane

Proporciona un fondo que se adapta al estilo y la temática de la aplicación

Popup

Tipo básico de controles de interfaz de usuario similares a ventanas emergentes

ProgressBar

Indica el progreso de una operación

RadioButton

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

RadioDelegate

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

RangeSlider

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

RoundButton

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

ScrollBar

Barra de desplazamiento interactiva vertical u horizontal

ScrollIndicator

Indicador de desplazamiento vertical u horizontal no interactivo

ScrollView

Vista desplazable

SearchField

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

SelectionRectangle

Se utiliza para seleccionar celdas de una tabla dentro de un TableView

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

SplitHandle

Proporciona propiedades asociadas para los controles deslizantes de SplitView

SplitView

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

StackView

Proporciona un modelo de navegación basado en pilas

SwipeDelegate

Delegado de elementos deslizables

SwipeView

Permite al usuario navegar por las páginas deslizando el dedo hacia los lados

Switch

Botón que se puede activar o desactivar

SwitchDelegate

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

TabBar

Permite al usuario cambiar entre diferentes vistas o subtareas

TabButton

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

TableViewDelegate

Un delegado que se puede asignar a una TableView

TextArea

Área de entrada de texto de varias líneas

TextField

Campo de entrada de texto de una sola línea

ToolBar

Contenedor para controles contextuales

ToolButton

Botón con un aspecto adecuado para una ToolBar

ToolSeparator

Separa un grupo de elementos de una barra de herramientas de los elementos adyacentes

ToolTip

Proporciona información sobre herramientas para cualquier control

TreeViewDelegate

Un delegado que se puede asignar a un TreeView

Tumbler

Rueda giratoria de elementos que se pueden seleccionar

VerticalHeaderView

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

VerticalHeaderViewDelegate

WeekNumberColumn

Una columna con los números de las semanas

Uso de los tipos de control « Qt Quick » en las declaraciones de propiedades

Tal y como se menciona en Qt Quick Templates 2 QML Types, cada tipo de los controles de Qt Quick se basa en un tipo «plantilla» de C++. Estos tipos son implementaciones no visuales de la lógica y el comportamiento de los controles.

Por ejemplo, la API y el comportamiento del tipo « Menu » vienen definidos por el tipo de C++ que se encuentra en « Qt Quick Templates». Cada estilo que desee proporcionar un menú debe disponer de un archivo Menu.qml, y el elemento raíz de dicho archivo debe ser el menú de Qt Quick Templates. Al importar QtQuick.Controls y crear un menú en QML, el tipo que se obtiene es, en realidad, el menú QML definido por el archivo Menu.qml del estilo.

Para utilizar un control como tipo en una declaración de propiedad, debes emplear el tipo correspondiente de las plantillas de Qt Quick. Por ejemplo, supongamos que tienes un componente PopupOpener, que es un botón que abre una ventana emergente:

// PopupButton.qml
import QtQuick.Controls

Button {
    required property Popup popup

    onClicked: popup.open()
}

// main.qml
PopupButton {
    popup: saveChangesDialog
}

Dialog {
    id: saveChangesDialog

    // ...
}

Al ejecutar este código se producirá un error:

Unable to assign Dialog_QMLTYPE to Popup_QMLTYPE

Esto se debe a la jerarquía de herencia:

Popup (C++ type in QtQuick.Templates)
│   └── Popup (QML type in QtQuick.Controls)
└── Dialog (C++ type in QtQuick.Templates)
    └── Dialog (QML type in QtQuick.Controls)

El «Dialog» de QtQuick.Controls no deriva del «Popup» de QtQuick.Controls, sino de QtQuick.Templates.

En su lugar, utiliza el Popup de Qt Quick Templates como tipo de propiedad:

// PopupButton.qml
import QtQuick.Controls
import QtQuick.Templates as T

Button {
    required property T.Popup popup

    onClicked: popup.open()
}

Para obtener más información sobre el módulo « Qt Quick Controls», consulte la documentación del módulo «Qt Quick Controls ».

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