Qt Quick Reference Documentation

Accessible

Affector

Age

AnchorAnimation

AnchorChanges

AngleDirection

AnimatedImage

Example Usage

AnimatedSprite

Animation

Animation and Transitions in Qt Quick

Animation and Transitions Types

Triggering Animations

Direct Property Animation

Using Predefined Targets and Properties

Transitions During State Changes

Default Animation as Behaviors

Playing Animations in Parallel or in Sequence

Controlling Animations

Animation Playback

Easing

Other Animation Types

Sharing Animation Instances

AnimationController

Animator

Attractor

Behavior

Best Practices for QML and Qt Quick

Custom UI Controls

Related Information

Coding Conventions

Bundle Application Resources

Related Information

Separate UI from Business Logic

Interacting with QML from C++

Pulling References from QML

Pushing References to QML

Related Information

Using Qt Design Studio

Related Information

Using Qt Quick Layouts

Dos

Don'ts

Related Information

Type Safety

Performance

Prefer Declarative Bindings Over Imperative Assignments

Tools and Utilities

Scene Graph

Scalable User Interfaces

Related Information

BorderImage

Example Usage

Image Loading

BorderImageMesh

BoundaryRule

C++ Extension Points Provided By Qt Quick

User-Defined QQuickItem-Derived Types

Scene Graph-Related Classes

Pixmap and Threaded Image Support

C++ Extensions: Image Provider Example

C++ Extensions: Image Response Provider Example

Canvas

Threaded Rendering and Render Target

Pixel Operations

Tips for Porting Existing HTML5 Canvas Applications

CanvasGradient

CanvasImageData

CanvasPixelArray

CloseEvent

ColorAnimation

Column

Using Transitions

ColumnLayout

Concepts - Visual Coordinates in Qt Quick

Item Coordinates

Scene Coordinates

Worked Example

Concepts - Visual Parent in Qt Quick

Visual Parent

Item Coordinates

Stacking Order

Canvas Ownership

ConicalGradient

Context2D

CumulativeDirection

CustomParticle

Direction

DoubleValidator

Drag

DragEvent

DragHandler

DropArea

EllipseShape

Emitter

EnterKey

EventPoint

EventTouchPoint

Flickable

Example Usage

Examples of contentX and contentY

Limitations

Flipable

Example Usage

Flow

FocusScope

FolderListModel

Filtering

Example Usage

Path Separators

FontLoader

FontMetrics

Friction

GestureEvent

Gradient

Example Usage

Performance and Limitations

GradientStop

GraphicsInfo

Gravity

Grid

GridLayout

GridMesh

GridView

Example Usage

GridView Layouts

GroupGoal

HandlerPoint

HoverHandler

Image

Example Usage

OpenGL Texture Files

Automatic Detection of File Extension

Performance

ImageParticle

Important Concepts In Qt Quick - Convenience Types

Dynamic Object Instantiation

Dynamic Bindings

Dynamic Signal Connections

Timer-Based Events

Important Concepts In Qt Quick - Data - Models, Views and Data Storage

Models and Views

Data Storage and Access

Important Concepts In Qt Quick - Graphical Effects

Graphical Effects and Particles

Visual Transformation

Shader Effects

Particles

Sprites

Opacity

Important Concepts In Qt Quick - Positioning

Manual Positioning

Positioning With Bindings

Anchors

Positioners

Layouts

Right-To-Left Support

Important Concepts In Qt Quick - The Visual Canvas

Coordinate System

Visual Parent

Scene Graph

Important Concepts In Qt Quick - User Input

Input from Pointing Devices

Keyboard Input and Keyboard Focus

Device Motion Gestures

Important Concepts In Qt Quick - Visual Types

Important Concepts in Qt Quick - States, Transitions and Animations

States

Transitions

Animations

Animating Property Assignments

Animators

Animated Sprites

IntValidator

Item

Event Handling

Layout Mirroring

Item Layers

Layer Opacity vs Item Opacity

Combined with ShaderEffects

Memory and Performance

Item Positioners

Positioners

Column Items

Row Items

Grid Items

Flow Items

Other Ways to Position Items

ItemGrabResult

ItemParticle

KeyEvent

KeyNavigation

Keyboard Focus in Qt Quick

Key Handling Overview

Querying the Active Focus Item

Acquiring Focus and Focus Scopes

Advanced Uses of Focus Scopes

Keys

Example Usage

Key Handling Priorities

Layout

LayoutMirroring

LineShape

LinearGradient

ListView

Example Usage

ListView Layouts

Flickable Direction

Stacking Order in ListView

Reusing items

Loader

Loader Sizing Behavior

Receiving Signals from Loaded Objects

Focus and Key Events

Using a Loader within a View Delegate

MaskShape

Matrix4x4

Models and Views in Qt Quick

qml-c++-models

Displaying Data with Views

Decorating Views

Mouse and Touch Handling

ListView Sections

View Delegates

Accessing Views and Models from Delegates

Models

List Model

XML Model

Object Model

Integers as Models

Object Instances as Models

C++ Data Models

Repeaters

Changing Model Data

Using Transitions

Models and Views: AbstractItemModel Example

Models and Views: Object ListModel Example

Models and Views: String ListModel Example

Mouse Events

Mouse Types

Mouse Event Handling

Defining a Mouse Area

Receiving Events

Enabling Gestures

MouseEvent Object

Accepting Further Signals

MouseArea

Example Usage

MouseEvent

MultiPointHandler

MultiPointTouchArea

NumberAnimation

OpacityAnimator

OpenGLInfo

ParallelAnimation

ParentAnimation

ParentChange

Particle

Particle System Performance Guide

ParticleExtruder

ParticleGroup

ParticlePainter

ParticleSystem

Path

PathAngleArc

PathAnimation

PathArc

PathAttribute

PathCubic

PathCurve

PathElement

PathInterpolator

PathLine

PathMove

PathMultiline

PathPercent

PathPolyline

PathQuad

PathSvg

PathText

PathView

PauseAnimation

PinchArea

PinchEvent

PinchHandler

PointAttractor

PointDirection

PointHandler

PointerDevice

PointerDeviceHandler

PointerEvent

PointerHandler

PointerScrollEvent

Positioner

Positioning with Anchors

Anchor Margins and Offsets

Changing Anchors

Restrictions

PropertyAction

PropertyAnimation

PropertyChanges

Resetting Property Values

Immediate Property Changes in Transitions

QML Advanced Tutorial

QML Advanced Tutorial 1 - Creating the Game Canvas and Blocks

Creating the Application Screen

Adding Button and Block Components

QML Advanced Tutorial 2 - Populating the Game Canvas

Generating the Blocks in JavaScript

Connecting JavaScript Components to QML

QML Advanced Tutorial 3 - Implementing the Game Logic

Making a Playable Game

Enabling Mouse Click Interaction

Updating the Score

A Dash of Color

A Working Game

QML Advanced Tutorial 4 - Finishing Touches

Adding Some Flair

Animating Block Movement

Animating Block Opacity Changes

Adding Particle Effects

Keeping a High Scores Table

Storing High Scores Offline

Storing High Scores Online

That's It!

QML Dynamic View Ordering Tutorial

QML Dynamic View Ordering Tutorial 1 - A Simple ListView and Delegate

Walkthrough

QML Dynamic View Ordering Tutorial 2 - Dragging View Items

Walkthrough

QML Dynamic View Ordering Tutorial 3 - Moving Dragged Items

Walkthrough

QML Dynamic View Ordering Tutorial 4 - Sorting Items

Walkthrough

QML Tutorial

QML Tutorial 1 - Basic Types

Walkthrough

Import

Rectangle Type

Text Type

Viewing the Example

QML Tutorial 2 - QML Components

Walkthrough

The Cell Component

The Main QML File

QML Tutorial 3 - States and Transitions

Walkthrough

An Example

Asynchronous Image Loading

Image Caching

Custom Scene Graph Items

Graphics Resource Handling

Custom QPainter Items

Behavior Animations

QQuickRenderControl Example

Scene Graph and Context Persistency

Limitations

Support when not using OpenGL

Tab Key Handling

Rendering

Integration with OpenGL

Exposure and Visibility

Resource Management

Context and Surface Formats

Texture Atlasses

Qt Quick

Important Concepts in Qt Quick

C++ Extension Points

Licenses and Attributions

Reference Documentation

Qt Quick Direct3D 12 Adaptation

Motivation

Graphics Adapters

Troubleshooting

Render Loops

Renderer

Shader Effects

Multisample Render Targets

Semi-transparent Windows

Mipmaps

Image Formats

Unsupported Features

Related APIs

Advanced Configuration

Qt Quick Direct3D 12 Adaptation

Motivation

Graphics Adapters

Troubleshooting

Render Loops

Renderer

Shader Effects

Multisample Render Targets

Semi-transparent Windows

Mipmaps

Image Formats

Unsupported Features

Related APIs

Advanced Configuration

Qt Quick Examples - Accessibility

Running the Example

Implementing Accessible Buttons

Qt Quick Examples - Animation

Running the Example

ColorAnimation

PropertyAnimation

Animators

Behaviors

Wiggly Text

Tv Tennis

Easing Curves

States

Transitions

PathAnimation

PathInterpolator

Qt Quick Examples - Canvas

Running the Example

Red Heart

Talk Bubble

Squircle

Rounded Rectangle

Smile Face

Clip

Tiger

Qt Quick Examples - Drag and Drop

Running the Example

Tiles

GridView Example

Qt Quick Examples - Image Elements

Running the Example

Scaling with BorderImage

Image Fill

Shadow Effects

Sprite Animations with AnimatedSprite

Sprite Animations with SpriteSequence

Qt Quick Examples - Key Interaction

Running the Example

Qt Quick Examples - Local Storage

Running the Example

Activity Tracker

Qt Quick Examples - MouseArea

Running the Example

MouseArea Behavior

Qt Quick Examples - Positioners

Running the Example

Transitions

Attached Properties

Qt Quick Examples - Right to Left

Running the Example

Qt Quick Examples - Shader Effects

Running the Example

Using ShaderEffect

Qt Quick Examples - Shapes

Running the Example

Qt Quick Examples - Text

Hello

Fonts

Available Fonts

Banner

Img Tag

Text Layout

Qt Quick Examples - Threading

Running the Example

Threaded ListModel

WorkerScript

Qt Quick Examples - Toggle Switch

Switch.qml

Walkthrough

Interface

Images and User Interaction

States

Functions

Transition

Usage

Qt Quick Examples - Touch Interaction

Running the Example

Multipoint Flames Example

Bear-Whack Example

Flick Resize Example

Flickable Example

Corkboards Example

Qt Quick Examples - Views

Running the Example

Using GridView and PathView

Using Dynamic List

Expanding Delegates

Using Highlight

Using Highlight Ranges

Using Sections

Using Packages

Using ObjectModel

Using Display Margins

Qt Quick Examples - Window and Screen

Running the Example

Window Implementation

Qt Quick Examples - externaldraganddrop

Running the Example

Qt Quick Examples and Tutorials

Running the Examples and Demos

Qt Quick Demos

Developing Qt Quick Applications

Extending QML

Examples

Qt Quick Input Handlers

Input Handlers

Key Features

Handlers Manipulating Items

Handler Properties and Signals

Pointer Grab

Related Information

Qt Quick Layouts

Licenses

Layouts

Related Information

Qt Quick Layouts - Basic Example

Running the Example

Qt Quick Layouts Overview

Getting Started

Key Features

A Simple Layout

Size Constraints

Specifying Preferred Size

Connecting Windows and Layouts

Qt Quick OpenVG Adaptation

EGL Requirement

Renderer

Render Loop

Shader Effects

Qt Graphical Effects Module

Particle Effects

Rendering Text

Perspective Transforms

Qt Quick Particles Examples - Affectors

Qt Quick Particles Examples - CustomParticle

Qt Quick Particles Examples - Emitters

Qt Quick Particles Examples - Image Particles

Qt Quick Particles Examples - System

Qt Quick Scene Graph

The Scene Graph in Qt Quick

Qt Quick Scene Graph Structure

Nodes

Preprocessing

Node Ownership

Materials

Convenience Nodes

Scene Graph and Rendering

Threaded Render Loop ("threaded")

Non-threaded Render Loops ("basic" and "windows")

Custom control over rendering with QQuickRenderControl

Mixing Scene Graph and the native graphics API

Custom Items using QPainter

Logging Support

Scene Graph Backend

Qt Quick Scene Graph Default Renderer

Batching

Opaque Primitives

Alpha Blended Primitives

Mixing with 3D Primitives

Texture Atlas

Batch Roots

Transform Nodes

Clipping

Vertex Buffers

Antialiasing

Vertex Antialiasing

Multisample Antialiasing

Performance

Visualizing

Visualizing Batches

Visualizing Clipping

Visualizing Changes

Visualizing Overdraw

Rendering via the Qt Rendering Hardware Interface

Qt Quick Software Adaptation

Shader Effects

Qt Graphical Effects Module

Particle Effects

Rendering Text

Qt Multimedia VideoOutput

Qt Quick States

Related Types

Creating States

The Default State

The when Property

Animating State Changes

State Fast Forwarding

Qt Quick TableView examples - Conway’s Game of Life

Running the Example

The QML User Interface

The C++ Model

Updating the Data

Qt Quick TableViews examples - Pixelator

Running the Example

Qt Quick Text Input Handling and Validators

Text Visual Types

Validating Input Text

Qt Quick Text Validators

Qt Quick Tools and Utilities

Qt Quick Designer

QML Debugger and Profiler

Related Information

QmlLive, GammaRay, Squish, and Felgo QML Hot Reload

Related Information

Qt Creator

Related Information

Qt Quick Transformation Types

Item Properties

Transform List

Qt Quick Widgets Example

QtQuick.DragHandler

RadialGradient

Rectangle

Appearance

Example Usage

Performance

RectangleShape

RegExpValidator

RegularExpressionValidator

Repeater

Considerations when using Repeater

Right-to-left User Interfaces

Overview

Text Alignment

Layout Direction of Positioners and Views

Layout Mirroring

Mirroring Icons

Default Layout Direction

Rotation

RotationAnimation

RotationAnimator

Row

RowLayout

Scale

ScaleAnimator

Scene Graph - Custom Geometry

BezierCurve Declaration

BezierCurve Implementation

Application Entry-Point

Using the Item

Scene Graph - Custom Rendering with QSGRenderNode

Scene Graph - Direct3D 11 Under QML

Scene Graph - Graph

Scene Graph - Metal Texture Import

Scene Graph - Metal Under QML

Scene Graph - OpenGL Under QML

Scene Graph - Painted Item

TextBalloon Class Declaration

TextBalloon Class Definition

Textballoons.qml File

BalloonView

Controls

Scene Graph - Rendering FBOs

Scene Graph - Rendering FBOs in a thread

Scene Graph - Simple Material

Scene Graph - Two Texture Providers

Scene Graph - Vulkan Texture Import

Scene Graph - Vulkan Under QML

Scene Graph Adaptations

Switching Between the Adaptation Used by the Application

Scene Graph Adaptations in Qt Quick

Switch Between Adaptations in Your Application

Default Adaptation

Software Adaptation

Direct3D 12 (experimental)

OpenVG

Screen

ScriptAction

SequentialAnimation

Settings

Application Identifiers

Categories

Notes

ShaderEffect

OpenGL and GLSL

Direct3D and HLSL

Cross-platform, Cross-API ShaderEffect Items

ShaderEffect and Item Layers

Other Notes

ShaderEffectSource

Shape

ShapeGradient

ShapePath

Shortcut

SinglePointHandler

SmoothedAnimation

SpringAnimation

Sprite

Sprite Animations

Sprite Engine

State Machine

Input Format

QML Types Using the Sprite Engine

AnimatedSprite Type

SpriteGoal

SpriteSequence

StackLayout

State

StateChangeScript

StateGroup

SystemPalette

TabWidget Example

TableView

Example Usage

C++ Models

QML Models

Reusing items

Row heights and column widths

Overlays and underlays

TapHandler

TargetDirection

Text

TextEdit

TextInput

TextMetrics

Threaded ListModel Example

TouchPoint

TrailEmitter

Transform

Transition

Translate

Turbulence

UI Components: Dial Control Example

UI Components: Flipable Example

UI Components: Scroll Bar Example

UniformAnimator

Using C++ Models with Qt Quick Views

Data Provided In A Custom C++ Model

QStringList-based Model

QVariantList-based Model

QObjectList-based Model

QAbstractItemModel Subclass

SQL Models

Read-only Data Model

Editable Data Model

Exposing C++ Data Models to QML

Changing Model Data

Using Qt Quick Behaviors with States

Using Behaviors with States

Using the Qt Quick Particle System

The ParticleSystem

Logical Particles

Particle Groups

Emitters

ParticlePainters

Affectors

Stochastic Parameters

Directions

Shapes

Vector3dAnimation

ViewTransition

View Transitions: a Simple Example

Using the ViewTransition Attached Property

Delaying Animations Based on Index

Animating Items to Intermediate Positions

Handling Interrupted Animations

Restrictions Regarding ScriptAction

Wander

WavefrontMesh

WheelEvent

WheelHandler

Window

XAnimator

YAnimator

SVG Color Reference

qt5_import_qml_plugins

Overview

Description

Example

Qt Quick Scene Graph Material Classes

Qt Quick Scene Graph Node classes

Qt Quick C++ Classes

Qt Quick Widgets C++ Classes

Qt Quick experimental animation types

Qt Labs FolderListModel QML Types

Qt Labs Settings QML Types

Qt Quick Shared Image Provider

Summary

Usage

Qt Labs WavefrontMesh QML Types

Qt QML Base Types

Qt Quick QML Types

Submodules

Basic Types

Object Types

Qt Quick Layouts QML Types

Qt Quick Local Storage QML Types

openDatabaseSync

Methods

Detailed Description

Open or Create a Database

db.changeVersion(from, to, callback(tx))

db.transaction(callback(tx))

db.readTransaction(callback(tx))

results = tx.executeSql(statement, values)

Method Documentation

Qt Quick Particles QML Types

Qt Quick Shapes QML Types

Qt Quick Window QML Types