En esta página

Qt Quick QML Types

El módulo Qt Quick proporciona tipos gráficos primitivos. Estos tipos sólo están disponibles en un documento QML si dicho documento importa el espacio de nombres QtQuick.

Para utilizar el módulo, importe el módulo QtQuick con la siguiente sentencia:

import QtQuick

Visite la documentación del módulo Qt Quick para obtener más información sobre los conceptos centrales de QtQuick.

Submódulos

Qt Quick incluye varios submódulos que contienen tipos adicionales:

  • Local Storage - un submódulo que contiene una interfaz JavaScript para una base de datos SQLite
  • Particles - proporciona un sistema de partículas para aplicaciones QML
  • Controls - proporciona un conjunto de componentes de interfaz de usuario reutilizables
  • Layouts - contiene tipos que se utilizan para organizar elementos en la interfaz de usuario
  • Tests - tipos para probar aplicaciones QML.
  • Effects - proporciona tipos para aplicar uno o más efectos gráficos simples a los elementos de Qt Quick.
  • Shapes - proporciona tipos para representar formas vectoriales en una escena Qt Quick.
  • Vector Image - proporciona tipos para mostrar archivos de imágenes vectoriales.

Tipos de valores

Existen varios tipos de valores que el lenguaje QML admite por defecto.

Además, la importación QtQuick proporciona los siguientes tipos de valor:

color

Un valor de color ARGB

font

Valor de fuente con las propiedades de QFont. El tipo de fuente se refiere a un valor de fuente con las propiedades de QFont

matrix4x4

Un tipo matrix4x4 es una matriz de 4 filas y 4 columnas

quaternion

Un tipo quaternion tiene atributos escalares, x, y, z

vector2d

Un tipo vector2d tiene atributos x e y

vector3d

Valor con atributos x, y, y z

vector4d

Un tipo vector4d tiene atributos x, y, z y w

Tipos de objeto

La mayoría de los tipos de objeto proporcionados por la importación QtQuick se basan en el tipo Item, que a su vez deriva de QtObject. QML object types proporcionados por el módulo Qt QML (como QtObject y Component) también están disponibles al importar QtQuick.

Accessible

Permite la accesibilidad de los elementos QML

AnchorAnimation

Anima los cambios en los valores de anclaje

AnchorChanges

Especifica cómo cambiar las anclas de un elemento en un estado

AnimatedImage

Reproduce animaciones almacenadas como una serie de imágenes

AnimatedSprite

Dibuja una animación sprite

Animation

Es la base de todas las animaciones QML

AnimationController

Permite el control manual de las animaciones

Animator

Es la base de todos los animadores QML

Application

Proporciona acceso a propiedades de estado de aplicación globales compartidas por muchos componentes QML

Behavior

Define una animación por defecto para un cambio de propiedad

BorderImage

Pinta un borde basado en una imagen

BorderImageMesh

Define una malla con vértices dispuestos como los de una BorderImage

Canvas

Proporciona un elemento de lienzo 2D que permite dibujar mediante JavaScript

CanvasGradient

Proporciona una interfaz CanvasGradient opaca

CanvasImageData

Contiene datos de píxeles de imagen en orden RGBA

CanvasPixelArray

Proporciona acceso ordenado e indexado a los componentes de cada píxel en los datos de imagen

CloseEvent

Notificación de que una ventana está a punto de cerrarse

ColorAnimation

Anima los cambios en los valores de color

ColorGroup

Conjunto de colores por roles

Column

Posiciona sus hijos en una columna

Context2D

Proporciona contexto 2D para las formas en un elemento del lienzo

DoubleValidator

Define un validador para números no enteros

Drag

Para especificar eventos de arrastrar y soltar para Elementos movidos

DragEvent

Proporciona información sobre un evento de arrastre

DragHandler

Manejador para arrastrar

DropArea

Para especificar el manejo de arrastrar y soltar en un área

EnterKey

Proporciona una propiedad para manipular la apariencia de la tecla Intro en un teclado en pantalla

Flickable

Proporciona una superficie que puede ser "flickeada

Flipable

Proporciona una superficie que se puede voltear

Flow

Posiciona sus hijos uno al lado del otro, envolviéndolos si es necesario.

FocusScope

Crea explícitamente un ámbito de enfoque

FontInfo

Proporciona información sobre cómo se resuelve una consulta de fuente determinada.

FontLoader

Permite cargar fuentes por URL

FontMetrics

Proporciona métricas para una fuente determinada

FrameAnimation

Activa un controlador en cada actualización de fotograma de animación

GestureEvent

Parámetro dado con la señal gestureStarted

Gradient

Define un relleno de degradado

GradientStop

Define el color en una posición de un gradiente

GraphicsInfo

Proporciona información sobre el backend de scenegraph y la API de gráficos utilizada por Qt Quick

Grid

Posiciona sus hijos en formación de malla

GridMesh

Define una malla con vértices dispuestos en cuadrícula

GridView

Para especificar una vista en cuadrícula de los elementos proporcionados por un modelo

HoverHandler

Controlador del ratón y de la tableta

Image

Muestra una imagen

InputMethod

Proporciona acceso a QInputMethod para aplicaciones QML

IntValidator

Define un validador para valores enteros

Item

Un tipo visual básico de QML

ItemGrabResult

Contiene los resultados de una llamada a Item::grabToImage()

KeyEvent

Proporciona información sobre un evento clave

KeyNavigation

Soporta la navegación mediante teclas de flecha

Keys

Proporciona manejo de teclas a los ítems

LayoutMirroring

Propiedad utilizada para reflejar el comportamiento del diseño

ListView

Proporciona una vista de lista de los elementos proporcionados por un modelo

Loader

Permite la carga dinámica de un subárbol desde una URL o Componente

Matrix4x4

Permite aplicar una matriz de transformación 4x4 a un elemento

MouseArea

Permite un manejo sencillo del ratón

MouseEvent

Proporciona información sobre un evento de ratón

MultiPointHandler

Manejador abstracto para eventos de puntero multipunto

MultiPointTouchArea

Permite el manejo de múltiples puntos de contacto

NumberAnimation

Anima los cambios en los valores de tipo qreal

OpacityAnimator

Tipo anima la opacidad de un Item

Palette

Contiene grupos de colores para cada estado de elemento QML

ParallelAnimation

Permite que las animaciones se ejecuten en paralelo

ParentAnimation

Anima los cambios en los valores de los padres

ParentChange

Especifica cómo reparent un elemento en un cambio de estado

Path

Define una ruta para su uso por PathView y Shape

PathAngleArc

Define un arco con los radios y el centro dados

PathAnimation

Anima un ítem a lo largo de un camino

PathArc

Define un arco con el radio dado

PathAttribute

Especifica cómo establecer un atributo en una posición determinada de una trayectoria

PathCubic

Define una curva de Bézier cúbica con dos puntos de control

PathCurve

Define un punto en una curva Catmull-Rom

PathElement

El tipo de trayectoria base

PathInterpolator

Especifica cómo animar manualmente a lo largo de una trayectoria

PathLine

Define una línea recta

PathMove

Mueve la posición de la trayectoria

PathMultiline

Define un conjunto de polilíneas mediante una lista de coordenadas

PathPercent

Manipula la forma en que se interpreta una trayectoria

PathPolyline

Define una polilínea a través de una lista de coordenadas

PathQuad

Define una curva de Bézier cuadrática con un punto de control

PathRectangle

Define un rectángulo con esquinas redondeadas opcionalmente

PathSvg

Define un trazado utilizando una cadena de datos de trazado SVG

PathText

Define una cadena en una fuente especificada

PathView

Distribuye los elementos proporcionados por el modelo en un trazado

PauseAnimation

Permite pausar una animación

PinchArea

Habilita la gestión de gestos de pellizco sencillos

PinchEvent

Para especificar información sobre un evento de pellizco

PinchHandler

Manipulador de gestos de pellizco

PlanarTransform

Proporciona funciones de utilidad para matrix4x4 cuando se utiliza para transformaciones 2D

PointHandler

Manejador para reaccionar a un único punto de contacto

PointerDevice

Equivalente QML para QPointingDevice

PointerDeviceHandler

Gestor abstracto de eventos de puntero con restricciones específicas del dispositivo

PointerEvent

Equivalente en QML de QPointerEvent

PointerHandler

Gestor abstracto de eventos de puntero

Positioner

Proporciona propiedades adjuntas que contienen detalles sobre dónde existe un elemento en un posicionador

PropertyAction

Especifica cambios de propiedad inmediatos durante la animación

PropertyAnimation

Anima los cambios en los valores de las propiedades

PropertyChanges

Describe nuevas propiedades o valores para un estado

Rectangle

Pinta un rectángulo relleno con un borde opcional

RegularExpressionValidator

Proporciona un validador de cadenas

Repeater

Instancia de un número de componentes basados en ítems utilizando un modelo proporcionado.

Rotation

Permite rotar un elemento

RotationAnimation

Anima los cambios en los valores de rotación

RotationAnimator

El tipo anima la rotación de un elemento

Row

Posiciona sus hijos en una fila

SafeArea

Proporciona acceso a las propiedades de área segura del elemento o ventana

Scale

Permite escalar un elemento

ScaleAnimator

El tipo anima el factor de escala de un elemento

Screen

El objeto adjunto proporciona información sobre la pantalla en la que se muestra un elemento o ventana

ScriptAction

Define scripts para ser ejecutados durante una animación

SequentialAnimation

Permite ejecutar animaciones secuencialmente

ShaderEffect

Aplica shaders personalizados a un rectángulo

ShaderEffectSource

Renderiza un ítem Qt Quick en una textura y la muestra

Shear

Proporciona una forma de cizallar un elemento

Shortcut

Proporciona atajos de teclado

SinglePointHandler

Manejador abstracto para Eventos de Puntero de un solo punto

SmoothedAnimation

Permite a una propiedad seguir suavemente un valor

SpringAnimation

Permite a una propiedad seguir un valor con un movimiento similar a un muelle

Sprite

Especifica animaciones de sprites

SpriteSequence

Dibuja una animación de sprite

State

Define configuraciones de objetos y propiedades

StateChangeScript

Especifica cómo ejecutar un script en un estado

StateGroup

Proporciona soporte de estado integrado para tipos que no son elementos

SystemPalette

Proporciona acceso a las paletas Qt

TableView

Proporciona una vista de tabla de elementos para mostrar datos de un modelo

TapHandler

Manipulador de toques y clics

Text

Especifica cómo añadir texto formateado a una escena

TextDocument

Una envoltura alrededor del QTextDocument de TextEdit

TextEdit

Muestra múltiples líneas de texto formateado editable

TextInput

Muestra una línea de texto editable

TextMetrics

Proporciona métricas para una fuente y un texto determinados

TextSelection

Representa una selección contigua de texto y sus propiedades

TouchPoint

Describe un punto táctil en un MultiPointTouchArea

Transform

Para especificar transformaciones avanzadas en elementos

Transition

Define transiciones animadas que se producen en los cambios de estado

Translate

Proporciona una forma de mover un Item sin cambiar sus propiedades x o y

TreeView

Proporciona una vista de árbol para mostrar los datos de un QAbstractItemModel

UniformAnimator

Tipo anima un uniforme de un ShaderEffect

Vector3dAnimation

Anima cambios en valores QVector3d

ViewTransition

Especifica elementos en transición en una vista

WheelEvent

Proporciona información sobre un evento de rueda de ratón

WheelHandler

Manejador para la rueda del ratón

Window

Crea una nueva ventana de nivel superior

WindowContainer

Permite incrustar QWindows arbitrarias en una escena Qt Quick

XAnimator

Type anima la posición x de un Item

YAnimator

Type anima la posición y de un Item

eventPoint

Equivalente Qml para QEventPoint

handlerPoint

Un punto de evento

pointingDeviceUniqueId

Equivalente QML de QPointingDeviceUniqueId

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