En esta página

Qt Quick QML Types

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

Para utilizar el módulo, importa el módulo QtQuick con la siguiente instrucción:

import QtQuick

Consulta la Qt Quick documentación del módulo para obtener más información sobre los conceptos fundamentales 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 Graphical Effects sencillos a elementos de « Qt Quick ».
  • Shapes - Proporciona tipos para renderizar formas vectoriales en una escena de « Qt Quick ».
  • Vector Image - Proporciona tipos para mostrar archivos de imagen vectorial.

Tipos de valor

Hay varios tipos de valor que son compatibles de forma predeterminada en el lenguaje QML.

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

color

Un valor de color ARGB

font

Un valor de fuente con las propiedades de QFont. El tipo «font» hace referencia 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 los atributos escalar, x, y y z

vector2d

Un tipo vector2d tiene los atributos x e y

vector3d

Valor con los atributos x, y y z

vector4d

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

Tipos de objeto

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

Accessible

Habilita la accesibilidad de los elementos QML

AnchorAnimation

Anima los cambios en los valores de anclaje

AnchorChanges

Especifica cómo cambiar los anclajes de un elemento en un estado

AnimatedImage

Reproduce animaciones almacenadas como una serie de imágenes

AnimatedSprite

Dibuja una animación de 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 de QML

Application

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

Behavior

Define una animación predeterminada para un cambio de propiedad

BorderImage

Dibuja un borde basado en una imagen

BorderImageMesh

Define una malla con vértices dispuestos como los de un 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 de los datos de imagen

CloseEvent

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

Color

Incluye funciones de utilidad para los colores

ColorAnimation

Anima los cambios en los valores de color

ColorGroup

Conjunto de colores por funciones

Column

Coloca sus elementos secundarios en una columna

Context2D

Proporciona un contexto 2D para las formas en un elemento Canvas

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 el arrastre

DropArea

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

EnterKey

Proporciona una propiedad para modificar el aspecto de la tecla Intro en un teclado en pantalla

Flickable

Proporciona una superficie que se puede «deslizar rápidamente»

Flipable

Proporciona una superficie que se puede voltear

Flow

Coloca sus elementos secundarios uno al lado del otro, ajustándolos según sea necesario

FocusScope

Crea explícitamente un ámbito de foco

FontInfo

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

FontLoader

Permite cargar fuentes mediante 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 proporcionado con la señal «gestureStarted»

Gradient

Define un relleno degradado

GradientStop

Define el color en una posición de un degradado

GraphicsInfo

Proporciona información sobre el backend del grafo de escena y la API gráfica utilizada por Qt Quick

Grid

Coloca a sus elementos hijos en una formación de cuadrícula

GridMesh

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

GridView

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

HoverHandler

Controlador para el desplazamiento del ratón y 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 de tecla

KeyNavigation

Admite la navegación mediante las teclas de flecha

Keys

Proporciona gestión de teclas a los elementos

LayoutMirroring

Propiedad utilizada para reflejar el comportamiento del diseño

ListView

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

Loader

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

Matrix4x4

Proporciona una forma de 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 del ratón

MultiPointHandler

Manejador abstracto para eventos de puntero multipunto

MultiPointTouchArea

Permite gestionar múltiples puntos táctiles

NumberAnimation

Anima los cambios en los valores de tipo qreal

OpacityAnimator

El tipo anima la opacidad de un elemento

Palette

Contiene grupos de colores para cada estado de los elementos QML

ParallelAnimation

Permite ejecutar animaciones en paralelo

ParentAnimation

Anima los cambios en los valores de los elementos padres

ParentChange

Especifica cómo reasignar la relación de parentesco de un elemento al cambiar de estado

Path

Define una ruta para su uso por parte de PathView y Shape

PathAngleArc

Define un arco con los radios y el centro indicados

PathAnimation

Anima un elemento a lo largo de una ruta

PathArc

Define un arco con el radio indicado

PathAttribute

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

PathCubic

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

PathCurve

Define un punto en una curva de Catmull-Rom

PathElement

El tipo de trazado base

PathInterpolator

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

PathLine

Define una línea recta

PathMove

Mueve la posición de la ruta

PathMultiline

Define un conjunto de polilíneas a través de una lista de listas de coordenadas

PathPercent

Manipula la forma en que se interpreta una ruta

PathPolyline

Define una polilínea a partir 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 una ruta utilizando una cadena de datos de ruta SVG

PathText

Define una cadena con una fuente especificada

PathView

Distribuye los elementos proporcionados por el modelo a lo largo de una ruta

PauseAnimation

Proporciona una pausa en una animación

PinchArea

Permite gestionar gestos sencillos de pellizco

PinchEvent

Para especificar información sobre un evento de pellizco

PinchHandler

Manejador de gestos de pellizco

PlanarTransform

Proporciona funciones de utilidad para la matriz 4x4 cuando se utiliza para transformaciones 2D

PointHandler

Manejador para reaccionar ante un único punto de contacto

PointerDevice

Equivalente en QML para QPointingDevice

PointerDeviceHandler

Manejador abstracto para eventos de puntero con restricciones específicas del dispositivo

PointerEvent

Equivalente en QML de QPointerEvent

PointerHandler

Manejador abstracto para eventos de puntero

Positioner

Proporciona propiedades asociadas que contienen detalles sobre la ubicación de un elemento en un posicionador

PropertyAction

Especifica cambios inmediatos en las propiedades durante la animación

PropertyAnimation

Anima los cambios en los valores de las propiedades

PropertyChanges

Describe nuevos enlaces de propiedades o valores para un estado

Rectangle

Dibuja un rectángulo relleno con un borde opcional

RegularExpressionValidator

Proporciona un validador de cadenas

Repeater

Instancia varios componentes basados en «Item» utilizando un modelo proporcionado

Rotation

Ofrece una forma de rotar un elemento

RotationAnimation

Anima los cambios en los valores de rotación

RotationAnimator

El tipo anima la rotación de un elemento

Row

Coloca sus elementos secundarios en una fila

SafeArea

Proporciona acceso a las propiedades del área segura del elemento o la 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 una ventana

ScriptAction

Define los scripts que se ejecutarán durante una animación

SequentialAnimation

Permite ejecutar animaciones de forma secuencial

ShaderEffect

Aplica sombreadores personalizados a un rectángulo

ShaderEffectSource

Renderiza un elemento « Qt Quick » en una textura y lo muestra

Shear

Ofrece una forma de aplicar un efecto de sesgo a un elemento

Shortcut

Proporciona atajos de teclado

SinglePointHandler

Manejador abstracto para eventos de puntero de un solo punto

SmoothedAnimation

Permite que una propiedad siga suavemente la evolución de un valor

SpringAnimation

Permite que una propiedad siga un valor con un movimiento similar al de un resorte

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

Ofrece soporte integrado de estados para tipos que no sean «Item»

SystemPalette

Proporciona acceso a las paletas de Qt

TableView

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

TapHandler

Manejo de toques y clics

Text

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

TextDocument

Un envoltorio en torno al QTextDocument subyacente de TextEdit

TextEdit

Muestra varias líneas de texto formateado y 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 al cambiar de estado

Translate

Ofrece una forma de mover un elemento sin modificar sus propiedades x o y

TreeView

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

UniformAnimator

El tipo anima un uniforme de un ShaderEffect

Vector3dAnimation

Anima los cambios en los valores de QVector3d

ViewTransition

Especifica los elementos que se encuentran en transición en una vista

WheelEvent

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

WheelHandler

Manejador para la rueda del ratón

Window

Crea una nueva ventana de nivel superior

WindowContainer

Permite incrustar QWindows arbitrarios en una escena de « Qt Quick »

XAnimator

El tipo anima la posición x de un elemento

YAnimator

El tipo anima la posición y de un elemento

color

Un valor de color ARGB

eventPoint

Equivalente en QML de QEventPoint

font

Valor de fuente con las propiedades de QFont. El tipo de fuente hace referencia a un valor de fuente con las propiedades de QFont

handlerPoint

Un punto de evento

matrix4x4

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

pointingDeviceUniqueId

Equivalente en QML para QPointingDeviceUniqueId

quaternion

Un tipo «cuaternión» tiene los atributos «escalar», «x», «y» y «z»

vector2d

Un tipo vector2d tiene los atributos x e y

vector3d

Valor con atributos x, y y z

vector4d

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

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