QtQuickDocs: 03/21/18

詳説 Qt Quick

はじめに

基礎

QML
Qt Quick
QML の構文
外部 JavaScript ファイル
オブジェクトアトリビュート

id アトリビュート
プロパティーアトリビュート
シグナルアトリビュート
シグナルハンドラーアトリビュート
メソッドアトリビュート
アタッチトプロパティーアトリビュート
アタッチトシグナルハンドラーアトリビュート
列挙アトリビュート

タイプ

QML 基本タイプ
QML オブジェクトタイプ
QML ビジュアルタイプ
QObject と QtObject
親オブジェクトとビジュアル親オブジェクト
QML ビジュアルタイプの重ね合わせ
ウィンドウ

シグナル

シグナルハンドラー

プロパティー

プロパティー変更通知シグナル
プロパティーバインディング
遅延プロパティー

整列

アンカー
ビュー
デリゲート
ポジショナー
レイアウト
リピーター
インスタンシエーター

ユーザ操作

キー操作

フォーカスとアクティブフォーカス

マウス操作
マルチタッチ操作
ジェスチャー操作
ドラグ&ドロップ操作

カスタム QML タイプ

コンポーネント

ファイルコンポーネント
インラインコンポーネント

カスタムプロパティー
デフォルトプロパティー
別名プロパティー
カスタムシグナル
フォーカススコープ

アクティブフォーカスプロクシー

コンポーネントスコープ
JavaScript スコープ

アニメーション

基本的なアニメーション
ステートとトランジション
イージング曲線
特化したアニメーション
アニメーションのグループ化

直列アニメーション
並列アニメーション
グループ化で併用するタイプ

シグナルハンドラーとアニメーション

デフォルトメソッド

モデルビュー

モデルビューの考え方
モデル
ビュー
デリゲート

動的 QML

ローダー

QML と C++ の統合

QObject オブジェクトシステム

QObject
オブジェクトの親子関係
メタオブジェクト
プロパティーシステム
シグナルとスロット
イベントシステム

イベントハンドラー
イベントフィルター
合成イベント

タイプシステム
QVariant

データクラス

暗黙の共有

コンテナクラス
スマートポインター
スレッド
QML アプリケーション

QQmlEngine
QQmlContext
QQmlComponent
QQmlIncubator
QQuickView
QQmlApplicationEngine

C++ オブジェクトを QML で使う
C++ クラスを QML で使う
C++ 列挙を QML で使う
C++ プロパティーを QML で使う
C++ シグナルを QML で使う
C++ スロットとメソッドを QML で呼び出す
C++ で QML アタッチトプロパティーを作成
QML オブジェクトを C++ で操作参照する
C++ モデルビュー

モデルビューアーキテクチャー
QStringListModel
C++ モデルを QML で使う
QAbstractListModel
QAbstractItemModel

C++ で QML ビジュアルタイプを作成

ペインター
シーングラフ

C++ で QML コレクションタイプを作成
C++ QML タイプのプラグイン化

拡張機能

Qt Quick Test
Qt Quick Controls 2
キャンバス
シェープ
シェーダーイフェクト
グラフィカルイフェクト
パーティクル
アニメーター

トピック

コーディング規約
タイプ記述
qml コマンド
qmlscene コマンド
コンポーネントスコープ編集中
シングルトン
モジュール

サンプルコード

Qt QML リファレンス

QtQml
QtQml.Models
QtQml.StateMachine

Qt 編集中
大域関数編集中
Binding 編集中
Component 編集中
Connections 編集中
console 編集中
Date -
DelegateModel 編集中
DelegateModelGroup 編集中
FinalState (Since: Qt 5.4)
font 編集中
fontInfo
HistoryState (Since: Qt 5.4)
Instantiator (Since: Qt 5.1) 編集中
ItemSelectionModel (Since: Qt 5.5) 編集中
ListElement 編集中
ListModel 編集中
Locale -
LoggingCategory (Since: Qt 5.8) 編集中
Number -
ObjectModel 編集中
QtObject
SignalTransition (Since: Qt 5.4)
StateMachine (Since: Qt 5.4)
String -
TimeoutTransition (Since: Qt 5.4)
Timer 編集中

Qt Quick リファレンス

QtQuick

Accessible
Affector
Age
AnchorAnimation
AnchorChanges 編集中
anchors 編集中
AnimatedImage 編集中
AnimatedSprite
Animation 編集中
AnimationController
Animator (Since: Qt 5.2) -
Attractor
Behavior 編集中
BorderImage -
BorderImageMesh (Since: Qt 5.8) -
Canvas (Since: Qt 5.0)
CanvasGradient (Since: Qt 5.0)
CanvasImageData
CanvasPixelArray
CloseEvent (Since: Qt 5.1)
ColorAnimation -
Column -
ConicalGradient (Since: Qt 5.10) -
Context2D (Since: Qt 5.0)
CumulativeDirection
CustomParticle
DelegateChooser (Since: Qt 5.12 tech preview, Qt.labs.qmlmodels 1.0)
Direction
DoubleValidator -
Drag -
DragEvent -
DropArea -
Easing 編集中
EllipseShape
Emitter
EnterKey (Since: Qt 5.6)
EventPoint
EventTouchPoint
Flickable -
Flipable -
Flow 編集中
FocusScope 編集中
FolderListModel -
FontLoader -
FontMetrics (Since: Qt 5.4)
Friction
GestureEvent -
Gradient -
GradientStop -
GraphicsInfo (Since: QtQuick 2.8)
Gravity
Grid -
GridMesh (Since: Qt 5.0) -
GridView -
GroupGoal
Image -
ImageParticle
IntValidator -
Item 編集中
ItemGrabResult
ItemParticle
KeyEvent -
KeyNavigation -
Keys -
LayoutMirroring -
LineShape
LinearGradient (Since: Qt 5.10)
ListView -
Loader 編集中
MaskShape
Matrix4x4
MouseArea -
MouseEvent -
MultiPointTouchArea -
NumberAnimation -
OpacityAnimator (Since: Qt 5.2) -
OpenGLInfo (Since: Qt 5.4)
ParallelAnimation
ParentAnimation (Since: Qt 5.0) 編集中
ParentChange 編集中
Package -
Particle
ParticleGroup
ParticlePainter
ParticleSystem
Path -
PathAngleArc -
PathAnimation (Since: Qt 5.0) -
PathArc -
PathAttribute -
PathCubic -
PathCurve -
PathElement -
PathInterpolator -
PathLine -
PathMove -
PathPercent -
PathQuad -
PathSvg -
PathView -
PauseAnimation -
Pinch (private)
PinchArea -
PinchEvent -
PointDirection -
PointerEvent
Positioner -
PropertyAction 編集中
PropertyAnimation -
PropertyChanges -
RadialGradient (Since: Qt 5.10)
Rectangle 編集中
RectangleShape
RegExpValidator -
Repeater 編集中
Rotation -
RotationAnimation -
RotationAnimator (Since: Qt 5.2) -
Row -
Scale -
ScaleAnimator (Since: Qt 5.2) -
Screen -
ScreenInfo
ScriptAction 編集中
SequentialAnimation
Settings -
ShaderEffect
ShaderEffectSource (Since: Qt 5.0)
Shape (Since: Qt 5.10)
ShapeGradient (Since: Qt 5.10)
ShapePath (Since: Qt 5.10)
Shortcut (Since: Qt 5.5)
SignalSpy (Since: Qt 4.8)
SmoothedAnimation -
SpringAnimation -
Sprite
SpriteGoal
SpriteSequence
State 編集中
State (Since: Qt 5.4) -
StateChangeScript
StateGroup
SystemPalette
TableView (Since: Qt 5.12) -
TargetDirection
TestCase (Since: Qt 4.8)
Text 編集中
TextEdit 編集中
TextInput 編集中
TextMetrics (Since: Qt 5.4) 編集中
TouchEventSequence (Since: Qt 5.9) -
TouchPoint -
TrailEmitter
Transform -
Transition 編集中
Translate -
Turbulence
UniformAnimator (Since: Qt 5.2) -
Vector3dAnimation -
ViewSection -
ViewTransition -
VisualDataGroup
VisualDataModel
VisualItemModel
Wander
WheelEvent -
Window -
WorkerScript 編集中
XAnimator (Since: Qt 5.2) -
XmlListModel -
XmlRole -
YAnimator (Since: Qt 5.2) -

QtQuick.Dialogs

ColorDialog
Dialog
FileDialog
FontDialog
MessageDialog

QtQuick.Layouts

Layout 編集中
ColumnLayout 編集中
RowLayout 編集中
GridLayout 編集中
StackLayout 編集中

QtQuick.LocalStorage

QtQuick.Particles

AngleDirection 編集中

QtQuick.Shapes

QtQuick.Window

QtQuick.XmListModel

Graphical Effects リファレンス

Blend

Blend

Color

BrightnessContrast
ColorOverlay
Colorize
Desaturate
GammaAdjust
HueSaturation
LevelAdjust

Gradient

ConicalGradient
LinearGradient
RadialGradient

Distortion

Displace

Drop Shadow

DropShadow
InnerShadow

Blur

FastBlur
GaussianBlur
MaskedBlur
RecursiveBlur
Motion Blur
DirectionalBlur
RadialBlur
ZoomBlur

Glow

Glow
RectangularGlow

Mask

OpacityMask
ThresholdMask

QtQuick

タイプ階層

QQuickPointerHandler
QQuickPointerDeviceHandler
QQuickSinglePointHandler
HoverHandler
PointHandler
TapHandler
QQuickMultiPointHandler
DragHandler
PinchHandler

DragHandler (Since: Qt 5.12) 編集中
HoverHandler (Since: Qt 5.12)
PinchHandler (Since: Qt 5.12)
PointHandler (Since: Qt 5.12)
TapHandler (Since: Qt 5.12)

QQuickSinglePointHandler (Since: Qt 5.12 internal)
QQuickPointerDeviceHandler (Since: Qt 5.12 internal)
QQuickMultiPointHandler (Since: Qt 5.12 internal)
QQuickPointerHandler (Since: Qt 5.12 internal)

Qt Quick Controls 2 リファレンス

Qt Quick Controls 2 の概要
スタイルのカスタマイズ
AbstractButton (Since: Qt 5.7)
Action (Since: Qt 5.10)
ActionGroup (Since: Qt 5.10)
ApplicationWindow (Since: Qt 5.7) -
BusyIndicator (Since: Qt 5.7) -
Button (Since: Qt 5.7) -
ButtonGroup (Since: Qt 5.7) -
CheckBox (Since: Qt 5.7) -
CheckDelegate (Since: Qt 5.7) -
ComboBox (Since: Qt 5.7) -
Container (Since: Qt 5.7) -
Control (Since: Qt 5.7) -
DelayButton (Since: Qt 5.9) -
Dial (Since: Qt 5.7) -
Dialog (Since: Qt 5.8) -
DialogButtonBox (Since: Qt 5.8) -
Drawer (Since: Qt 5.7) -
Frame (Since: Qt 5.7) -
GroupBox (Since: Qt 5.7) -
ItemDelegate (Since: Qt 5.7) -
Label (Since: Qt 5.7) -
Menu (Since: Qt 5.7) -
MenuBar (Since: Qt 5.10) -
MenuBarItem (Since: Qt 5.10) -
MenuItem (Since: Qt 5.7) -
MenuSeparator (Since: Qt 5.8) -
Overlay (Since: Qt 5.10) -
Page (Since: Qt 5.7) -
PageIndicator (Since: Qt 5.7) -
Pane (Since: Qt 5.7) -
Popup (Since: Qt 5.7) -
ProgressBar (Since: Qt 5.7) -
RadioButton (Since: Qt 5.7) -
RadioDelegate (Since: Qt 5.7) -
RangeSlider (Since: Qt 5.7) -
RoundButton (Since: Qt 5.8) -
ScrollBar (Since: Qt 5.7) -
ScrollIndicator (Since: Qt 5.7) -
ScrollView (Since: Qt 5.9) -
Slider (Since: Qt 5.7) -
SpinBox (Since: Qt 5.7) -
StackView (Since: Qt 5.7) -
SwipeDelegate (Since: Qt 5.7) -
SwipeView (Since: Qt 5.7) -
Switch (Since: Qt 5.7) -
SwitchDelegate (Since: Qt 5.7) -
TabBar (Since: Qt 5.7) -
TabButton (Since: Qt 5.7) -
TextArea (Since: Qt 5.7) -
TextField (Since: Qt 5.7) -
ToolBar (Since: Qt 5.7) -
ToolButton (Since: Qt 5.7) -
ToolSeparator (Since: Qt 5.8) -
ToolTip (Since: Qt 5.7) -
Tumbler (Since: Qt 5.7) -

モジュール

QtQuick 2.0

クラス継承

QQuickRectangle → QQuickItem → QObject

プロパティー

color: color = "#ffffffff"
border: QQuickPen* = QQuickPen(this) readonly constant
color: color = "#ff000000"
pixelAligned: bool = true
width: real = 1
gradient: Gradient = null
radius: real = 0

シグナル

void border.penChanged()

void colorChanged()
void radiusChanged()

説明

antialiasing を設定していない場合に radius を 0 以外に設定すると antialiasing が true になり、アンチエイリアスが自動的に有効になります。

border は読み込み専用で通知シグナルはありません。代わりに border.penChanged() シグナルがあり以下のようにして使います。

border.qml:

import QtQuick 2.10
import QtQuick.Window 2.10

Window {
    visible: true

    width: 400; height: 400

    color: "lightgrey"

    Rectangle {
        id: rect

        width: 200; height: 200
        anchors.centerIn: parent

        border {
            color: "black"
            width: 3

            onPenChanged: {
                print("Pen is changed");
            }
        }
        color: "red"
    }

    MouseArea {
        anchors.fill: parent

        onClicked: {
            if (Qt.colorEqual(rect.border.color, "black")) {
                rect.border.color = "green";
            } else {
                rect.border.color = "black";
            }
        }
    }
}

プロパティーの説明

color: color

border: QQuickPen*

border.color: color

border.pixelAligned: bool

border.width: real

縁の幅。border.pixelAligned が true の場合に、小数点以下で四捨五入した整数値が縁の幅になります。これがデフォルト動作です。

gradient: Gradient

radius: real

シグナルの説明

void border.penChanged()

border.color、border.pixelAligned、border.width のいずれかが変更されると送信される通知シグナル。

注意

border.width と border.color のデフォルト値はそれぞれ 1 と黒色ですが明示的に設定しないと縁は描画されません。border.width が 0 かどうかで縁の有無を判定する場合には border のプロパティーに初期値を設定する必要があります。

問題

Rectangle のリファレンスで、border.width の型が int になっているのは間違いで、real が正しい型です。int ならば浮動小数点数を設定すると小数点以下が切り捨てられて渡りますが、実際には浮動小数点数が渡り、内部で小数点以下で四捨五入しています。

Rectangle のリファレンスで、プロパティーに antialiasing が入っていますが、オーバーライドされてないので Rectangle のプロパティーではなく Item のプロパティーです。

参考情報

Rectangle QML Type

2018年3月21日

QtObject

モジュール

クラス継承

プロパティー

シグナル

メソッド

説明

プロパティーの説明

objectName: string

メソッドの説明

void destroy(int delay)

問題

参考情報

索引

詳説 Qt Quick

トピック

サンプルコード

Qt QML リファレンス

Qt Quick リファレンス

Graphical Effects リファレンス

QtQuick

Qt Quick Controls 2 リファレンス

Rectangle

モジュール

クラス継承

プロパティー

シグナル

説明

プロパティーの説明

color: color

border: QQuickPen*

border.color: color

border.pixelAligned: bool

border.width: real

gradient: Gradient

radius: real

シグナルの説明

void border.penChanged()

注意

問題

参考情報