Qt Quick QML Types

该 Qt Quick 模块提供了图形基元类型。只有当 QML 文档导入了QtQuick 命名空间时，这些类型才可在该文档中使用。

要使用该模块，请使用以下语句导入QtQuick 模块：

import QtQuick

请访问 Qt Quick 模块文档，了解有关QtQuick 核心概念的更多信息。

子模块

Qt Quick 包含若干子模块，其中包含其他类型：

Local Storage - 一个包含 SQLite 数据库 JavaScript 接口的子模块
Particles - 为 QML 应用程序提供了一个粒子系统
Controls - 提供了一组可重用的 UI 组件
Layouts - 包含用于在用户界面中排列项的类型
Tests - 用于测试 QML 应用程序的类型。
Effects - 提供用于对Qt Quick 项应用一个或多个简单Graphical Effects类型的类型
Shapes - 提供用于在Qt Quick 场景中渲染矢量形状的类型。
Vector Image - 提供用于显示矢量图像文件的类型。

值类型

QML 语言默认支持多种值类型。

此外，通过导入QtQuick ，还可使用以下值类型：

color	ARGB 颜色值
font	具有 QFont 属性的字体值。字体类型指具有 QFont 属性的字体值
matrix4x4	matrix4x4 类型是一个 4 行 4 列的矩阵
quaternion	四元数类型具有标量、x、y 和 z 属性
vector2d	vector2d 类型具有 x 和 y 属性
vector3d	具有 x、y 和 z 属性的值
vector4d	vector4d 类型具有 x、y、z 和 w 属性

对象类型

QtQuick 导入提供的绝大多数对象类型都基于Item 类型，而该类型本身又继承自QtObject 。当导入QtQuick 时，Qt Qml 模块提供的QML object types （例如QtObject 和Component ）同样可用。

Accessible	启用 QML 项的可访问性
AnchorAnimation	对锚点值的变更进行动画效果处理
AnchorChanges	指定如何在状态中更改项的锚点
AnimatedImage	播放以图像序列形式存储的动画
AnimatedSprite	绘制精灵动画
Animation	是所有 QML 动画的基础
AnimationController	支持手动控制动画
Animator	是所有 QML 动画器的基类
Application	提供对由许多 QML 组件共享的全局应用程序状态属性的访问
Behavior	为属性变化定义默认动画
BorderImage	根据图像绘制边框
BorderImageMesh	定义一个顶点排列方式与 BorderImage 相同的网格
Canvas	提供一个 2D 画布项，支持通过 JavaScript 进行绘制
CanvasGradient	提供一个不透明的 CanvasGradient 接口
CanvasImageData	包含按RGBA顺序排列的图像像素数据
CanvasPixelArray	提供对图像数据中每个像素的组件进行按序和按索引访问的功能
CloseEvent	通知窗口即将关闭
Color	包含用于处理颜色的实用函数
ColorAnimation	对颜色值的变更进行动画处理
ColorGroup	按角色划分的颜色集
Column	将子元素排列成一列
Context2D	为画布（Canvas）项上的形状提供 2D 上下文
DoubleValidator	为非整数定义验证器
Drag	用于为被移动的项目指定拖放事件
DragEvent	提供有关拖动事件的信息
DragHandler	拖拽处理程序
DropArea	用于指定区域内的拖放处理
EnterKey	提供一个属性，用于控制屏幕键盘上“Enter”键的外观
Flickable	提供一个可“轻扫”的表面
Flipable	提供一个支持翻转的区域
Flow	将子元素并排布局，必要时进行换行
FocusScope	显式创建焦点范围
FontInfo	提供有关给定字体查询如何被解析的信息
FontLoader	允许通过 URL 加载字体
FontMetrics	为给定字体提供度量值
FrameAnimation	在每个动画帧更新时触发处理程序
GestureEvent	随 gestureStarted 信号传递的参数
Gradient	定义渐变填充
GradientStop	定义渐变中某位置的颜色
GraphicsInfo	提供有关场景图后端以及所使用的图形 API 的信息Qt Quick
Grid	将子节点以网格形式排列
GridMesh	定义一个顶点按网格排列的网格
GridView	用于指定模型提供的项目的网格视图
HoverHandler	鼠标和平板悬停处理程序
Image	显示图像
InputMethod	为 QML 应用程序提供对 QInputMethod 的访问
IntValidator	定义整数值验证器
Item	一种基本的 QML 可视化类型
ItemGrabResult	包含调用 Item::grabToImage() 所得的结果
KeyEvent	提供有关键事件的信息
KeyNavigation	支持通过方向键进行键导航
Keys	为 Item 提供键处理功能
LayoutMirroring	用于映射布局行为的属性
ListView	提供由模型提供的项的列表视图
Loader	允许从 URL 或组件动态加载子树
Matrix4x4	提供了一种将 4x4 变换矩阵应用于项的方法
MouseArea	支持简单的鼠标处理
MouseEvent	提供有关鼠标事件的信息
MultiPointHandler	多点指针事件的抽象处理程序
MultiPointTouchArea	支持处理多个触点
NumberAnimation	对 qreal 类型值的变更进行动画处理
OpacityAnimator	该类型可对项的透明度进行动画处理
Palette	包含每个 QML 项状态的颜色组
ParallelAnimation	支持动画并行运行
ParentAnimation	对父级值的变更进行动画效果
ParentChange	指定在状态变化时如何为项重新设置父项
Path	定义供 PathView 和 Shape 使用的路径
PathAngleArc	定义一个具有指定半径和中心的弧
PathAnimation	沿路径对项目进行动画处理
PathArc	定义一个具有给定半径的弧
PathAttribute	指定如何在路径的指定位置设置属性
PathCubic	定义一条具有两个控制点的三次贝塞尔曲线
PathCurve	定义 Catmull-Rom 曲线上的一个点
PathElement	基本路径类型
PathInterpolator	指定如何沿路径手动制作动画
PathLine	定义一条直线
PathMove	移动路径的位置
PathMultiline	通过一组坐标列表定义一组多段线
PathPercent	控制路径的解析方式
PathPolyline	通过一组坐标列表定义折线
PathQuad	定义一条带有控制点的二次贝塞尔曲线
PathRectangle	定义一个矩形（可选圆角）
PathSvg	使用 SVG 路径数据字符串定义路径
PathText	定义指定字体的字符串
PathView	在路径上布局模型提供的元素
PauseAnimation	为动画提供暂停功能
PinchArea	启用简单的捏合手势处理
PinchEvent	用于指定有关捏合事件的信息
PinchHandler	捏合手势的处理程序
PlanarTransform	提供用于 2D 变换时的 4x4 矩阵辅助函数
PointHandler	用于响应单点触控的处理程序
PointerDevice	QPointingDevice 的 QML 等效实现
PointerDeviceHandler	具有设备特定约束条件的指针事件抽象处理程序
PointerEvent	QML 中与 QPointerEvent 对应的实现
PointerHandler	用于指针事件的抽象处理程序
Positioner	提供包含项目在定位器中具体位置信息的附加属性
PropertyAction	指定动画过程中的即时属性变化
PropertyAnimation	对属性值的变更进行动画处理
PropertyChanges	描述状态的新属性绑定或值
Rectangle	绘制一个带填充的矩形（可选边框）
RegularExpressionValidator	提供字符串验证器
Repeater	使用提供的模型实例化多个基于 Item 的组件
Rotation	提供旋转“项”的方法
RotationAnimation	对旋转值的更改进行动画处理
RotationAnimator	该类型会为“Item”的旋转效果添加动画
Row	将子元素以一行排列
SafeArea	提供对项或窗口安全区域属性的访问
Scale	提供了一种缩放项的方法
ScaleAnimator	该类型对项目的缩放因子进行动画处理
Screen	“Attached object” 提供有关显示该项或窗口的屏幕的信息
ScriptAction	定义在动画过程中要运行的脚本
SequentialAnimation	允许动画按顺序运行
ShaderEffect	将自定义着色器应用到矩形上
ShaderEffectSource	将Qt Quick 项渲染为纹理并显示
Shear	提供了一种对项目进行剪切的方法
Shortcut	提供键盘快捷键
SinglePointHandler	单点指针事件的抽象处理程序
SmoothedAnimation	允许属性平滑地追踪某个值
SpringAnimation	允许属性以弹簧般的运动方式跟踪值
Sprite	指定精灵动画
SpriteSequence	绘制精灵动画
State	定义对象和属性的配置
StateChangeScript	指定如何在某个状态下运行脚本
StateGroup	为非Item类型提供内置状态支持
SystemPalette	提供对 Qt 调色板的访问
TableView	提供项目表格视图，用于显示模型中的数据
TapHandler	用于处理轻触和点击的处理程序
Text	指定如何将格式化文本添加到场景中
TextDocument	TextEdit 底层 QTextDocument 的封装类
TextEdit	显示多行可编辑的格式化文本
TextInput	显示一行可编辑的文本
TextMetrics	为给定的字体和文本提供度量数据
TextSelection	表示一段连续选中的文本及其属性
TouchPoint	描述 MultiPointTouchArea 中的一个触点
Transform	用于为项目指定高级变换
Transition	定义在状态变化时发生的动画过渡
Translate	提供了一种在不更改项的 x 或 y 属性的情况下移动项的方法
TreeView	提供树形视图，用于显示来自 QAbstractItemModel 的数据
UniformAnimator	该类型对 ShaderEffect 的 uniform 属性进行动画处理
Vector3dAnimation	对 QVector3d 值的变化进行动画处理
ViewTransition	指定视图中处于过渡状态的项目
WheelEvent	提供有关鼠标滚轮事件的信息
WheelHandler	鼠标滚轮处理程序
Window	创建一个新的顶级窗口
WindowContainer	允许将任意 QWindows 嵌入到Qt Quick 场景中
XAnimator	该类型可对项的 x 坐标进行动画处理
YAnimator	该类型对项的y坐标进行动画处理
color	ARGB颜色值
eventPoint	QEventPoint的Qml等效表示
font	具有 QFont 属性的字体值。字体类型指具有 QFont 属性的字体值
handlerPoint	一个事件点
matrix4x4	4x4 矩阵类型是一个 4 行 4 列的矩阵
pointingDeviceUniqueId	QPointingDeviceUniqueId 的 QML 等效表达式
quaternion	四元数类型具有标量、x、y 和 z 属性
vector2d	vector2d 类型具有 x 和 y 属性
vector3d	具有 x、y 和 z 属性的值
vector4d	vector4d 类型具有 x、y、z 和 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.