Qt Quick QML Types

该 Qt Quick模块提供图形原始类型。这些类型只有在 QML 文档导入QtQuick 命名空间时才可用。

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

import QtQuick

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

子模块

Qt Quick 包括几个包含附加类型的子模块：

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

值类型

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

此外，QtQuick 导入还提供以下值类型：

color	ARGB 颜色值
font	具有 QFont 属性的字体值。字体类型指的是具有 QFont 属性的字体值。
matrix4x4	matrix4x4 类型是一个 4 行 4 列的矩阵。
quaternion	四元数类型具有标量、x、y 和 z 属性
vector2d	向量 2d 类型具有 x 和 y 属性
vector3d	具有 x、y 和 z 属性的值
vector4d	向量 4d 类型具有 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	定义一个网格，网格顶点的排列与边框图像类似
Canvas	提供二维画布项，可通过 JavaScript 进行绘制
CanvasGradient	提供不透明的 CanvasGradient 接口
CanvasImageData	包含按 RGBA 顺序排列的图像像素数据
CanvasPixelArray	提供对图像数据中每个像素组件的有序和索引访问
CloseEvent	通知窗口即将关闭
ColorAnimation	为颜色值的变化提供动画效果
ColorGroup	按角色设置颜色
Column	在列中定位其子单元
Context2D	为画布项目上的形状提供 2D 上下文
DoubleValidator	为非整数定义验证器
Drag	为移动的项目指定拖放事件
DragEvent	提供有关拖放事件的信息
DragHandler	拖动处理程序
DropArea	用于指定区域中的拖放处理
EnterKey	提供一个属性，用于操作屏幕键盘上回车键的外观
Flickable	提供可 "轻弹 "的表面
Flipable	提供可翻转的表面
Flow	将其子对象并排定位，必要时进行包装
FocusScope	明确创建焦点范围
FontInfo	提供有关如何解决给定字体查询的信息
FontLoader	允许通过 URL 加载字体
FontMetrics	提供给定字体的度量
FrameAnimation	在每次动画帧更新时触发一个处理程序
GestureEvent	与手势开始信号一起给出参数
Gradient	定义渐变填充
GradientStop	定义渐变中某个位置的颜色
GraphicsInfo	提供有关场景图后台和图形应用程序接口的信息。Qt Quick
Grid	在网格中定位其子网格
GridMesh	定义网格，其顶点按网格排列
GridView	用于指定模型所提供项目的网格视图
HoverHandler	鼠标和平板悬停处理程序
Image	显示图像
InputMethod	为 QML 应用程序提供访问 QInputMethod 的途径
IntValidator	为整数值定义验证器
Item	一个基本的可视化 QML 类型
ItemGrabResult	包含调用 Item::grabToImage() 的结果
KeyEvent	提供有关按键事件的信息
KeyNavigation	支持箭头键导航
Keys	为项目提供按键处理
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	当矩阵 4x4 用于二维变换时，为其提供实用功能
PointHandler	对单个触摸点作出反应的处理程序
PointerDevice	相当于 QPointingDevice 的 QML
PointerDeviceHandler	具有特定设备约束的指针事件抽象处理程序
PointerEvent	相当于 QPointerEvent 的 QML
PointerHandler	指针事件的抽象处理程序
Positioner	提供附加属性，其中包含项目在定位器中存在位置的详细信息
PropertyAction	在动画期间指定即时属性变化
PropertyAnimation	动画显示属性值的变化
PropertyChanges	描述新的属性绑定或状态值
Rectangle	绘制带有可选边框的填充矩形
RegularExpressionValidator	提供字符串验证器
Repeater	使用提供的模型实例化多个基于项的组件
Rotation	提供旋转项的方法
RotationAnimation	将旋转值的变化动画化
RotationAnimator	以动画形式显示项的旋转
Row	在一行中定位其子控件
SafeArea	提供项目或窗口安全区域属性的访问权限
Scale	提供缩放项的方法
ScaleAnimator	通过动画类型改变项的缩放系数
Screen	附加对象提供关于项目或窗口所显示屏幕的信息
ScriptAction	定义动画期间要运行的脚本
SequentialAnimation	允许按顺序运行动画
ShaderEffect	为矩形应用自定义着色器
ShaderEffectSource	将Qt Quick 项目渲染为纹理并显示出来
Shear	提供剪切项目的方法
Shortcut	提供键盘快捷键
SinglePointHandler	单点指针事件的抽象处理程序
SmoothedAnimation	允许属性平滑跟踪值
SpringAnimation	允许属性以类似弹簧的运动方式跟踪数值
Sprite	指定精灵动画
SpriteSequence	绘制精灵动画
State	定义对象和属性的配置
StateChangeScript	指定如何在状态下运行脚本
StateGroup	为非项目类型提供内置状态支持
SystemPalette	提供对 Qt 调色板的访问
TableView	提供项目的表格视图，以显示模型中的数据
TapHandler	轻点和点击处理程序
Text	指定如何在场景中添加格式化文本
TextDocument	对 TextEdit 的支持 QTextDocument 进行封装
TextEdit	显示多行可编辑的格式化文本
TextInput	显示一行可编辑的文本
TextMetrics	为给定的字体和文本提供度量标准
TextSelection	代表文本的连续选区及其属性
TouchPoint	描述多点触摸区域中的触摸点
Transform	用于指定项目的高级变换
Transition	定义在状态变化时发生的动画转换
Translate	提供了在不改变项的 x 或 y 属性的情况下移动项的方法
TreeView	提供树形视图，显示来自 QAbstractItemModel 的数据
UniformAnimator	为着色器效果的制服动画类型
Vector3dAnimation	动画 QVector3d 值的变化
ViewTransition	指定视图中正在过渡的项目
WheelEvent	提供有关鼠标滚轮事件的信息
WheelHandler	鼠标滚轮的处理程序
Window	创建新的顶层窗口
WindowContainer	允许在Qt Quick 场景中嵌入任意 QWindows
XAnimator	类型动画显示项的 x 位置
YAnimator	可使项的 y 位置动画化的类型
eventPoint	与 QEventPoint 相对应的 Qml
handlerPoint	一个事件点
pointingDeviceUniqueId	相当于 QPointingDeviceUniqueId 的 QML 代码

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