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.ControlsTipos QML
Tipo base abstracto que proporciona la funcionalidad común a los botones | |
Acción abstracta de interfaz de usuario | |
Agrupa acciones | |
Ventana de nivel superior con estilo, compatible con encabezado y pie de página | |
Indica actividad en segundo plano, por ejemplo, mientras se carga el contenido | |
Botón en el que se puede hacer clic para ejecutar un comando o responder a una pregunta | |
Grupo de botones de selección mutuamente excluyentes | |
Un espacio de nombres de calendario | |
Un modelo de calendario | |
Botón de selección que se puede activar o desactivar | |
Delegado de elemento con un indicador de selección que se puede activar o desactivar | |
Botón combinado con lista emergente para seleccionar opciones | |
Tipo base abstracto que proporciona funcionalidad común a los contenedores | |
El tipo adjunto permite abrir un menú contextual de forma adecuada a la plataforma | |
Tipo base abstracto que proporciona funcionalidad común a todos los controles | |
Una fila con los nombres de los días de la semana | |
Botón de selección que se activa al mantenerlo pulsado el tiempo suficiente | |
Dial circular que se gira para establecer un valor | |
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 | |
Un cuadro de botones utilizado en los cuadros de diálogo | |
Permite al usuario seleccionar entre un conjunto de valores de coma flotante predefinidos | |
Panel lateral que se puede abrir y cerrar con un gesto de deslizamiento | |
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 encabezado horizontal para acompañar a un TableView | |
Delegado de elemento básico que se puede utilizar en diversas vistas y controles | |
Etiqueta de texto con estilo y fuente heredada | |
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ú | |
Separa un grupo de elementos de un menú de los elementos adyacentes | |
Una cuadrícula de días para un mes del calendario | |
Una superposición de ventana para ventanas emergentes | |
Control de página con estilo y compatibilidad con encabezado y pie de página | |
Indica la página actualmente activa | |
Proporciona un fondo que se adapta al estilo y la temática de la aplicación | |
Tipo básico de controles de interfaz de usuario similares a ventanas emergentes | |
Indica el progreso de una operación | |
Botón de opción exclusivo que se puede activar o desactivar | |
Delegado de elemento exclusivo con un indicador de radio que se puede activar o desactivar | |
Se utiliza para seleccionar un rango de valores deslizando dos controles a lo largo de una pista | |
Un control de botón pulsador con esquinas redondeadas en el que el usuario puede hacer clic | |
Barra de desplazamiento interactiva vertical u horizontal | |
Indicador de desplazamiento vertical u horizontal no interactivo | |
Vista desplazable | |
Un campo de entrada especializado diseñado para la función de búsqueda | |
Se utiliza para seleccionar celdas de una tabla dentro de un TableView | |
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 | |
Proporciona propiedades asociadas para los controles deslizantes de SplitView | |
Dispone los elementos con un separador arrastrable entre cada uno de ellos | |
Proporciona un modelo de navegación basado en pilas | |
Delegado de elementos deslizables | |
Permite al usuario navegar por las páginas deslizando el dedo hacia los lados | |
Botón que se puede activar o desactivar | |
Delegado de elemento con un indicador de conmutación que se puede activar o desactivar | |
Permite al usuario cambiar entre diferentes vistas o subtareas | |
Botón con un aspecto adecuado para una barra de pestañas | |
Un delegado que se puede asignar a una TableView | |
Área de entrada de texto de varias líneas | |
Campo de entrada de texto de una sola línea | |
Contenedor para controles contextuales | |
Botón con un aspecto adecuado para una ToolBar | |
Separa un grupo de elementos de una barra de herramientas de los elementos adyacentes | |
Proporciona información sobre herramientas para cualquier control | |
Un delegado que se puede asignar a un TreeView | |
Rueda giratoria de elementos que se pueden seleccionar | |
Ofrece una vista de encabezado vertical para acompañar a un TableView | |
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_QMLTYPEEsto 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 ».
Información relacionada
© 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.