Behavior QML Type

プロパティ変更時のデフォルトのアニメーションを定義します。詳細...

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• animation : Animation
• enabled : bool
• targetProperty (since QtQuick 2.15)
  • targetProperty.name : string (since QtQuick 2.15)
  • targetProperty.object : QtObject (since QtQuick 2.15)
• targetValue : Variant (since QtQuick 2.13)

詳細説明

Behavior は、特定のプロパティの値が変化したときに適用されるデフォルトのアニメーションを定義します。

たとえば、次のビヘイビアはRectangle のwidth の値が変化するたびに実行されるNumberAnimation を定義します。MouseArea がクリックされると、width が変更され、ビヘイビアのアニメーションがトリガーされます：

import QtQuick

Rectangle {
    id: rect
    width: 100; height: 100
    color: "red"

    Behavior on width {
        NumberAnimation { duration: 1000 }
    }

    MouseArea {
        anchors.fill: parent
        onClicked: rect.width = 50
    }
}

1つのプロパティに複数のビヘイビアを割り当てることはできません。1つのビヘイビアに複数のアニメーションを設定するには、ParallelAnimation またはSequentialAnimation を使用してください。

ステートチェンジがビヘイビアと同じプロパティにマッチするTransition を持つ場合、Transition のアニメーションはそのステートチェンジのビヘイビアをオーバーライドします。ビヘイビアを使用してステート変更をアニメーション化する一般的なアドバイスについては、「Qt Quick ビヘイビアとステートを使用する」を参照してください。

アニメーションとトランジション（Qt Quick） 、ビヘイビアの例、および Qt Qml.

プロパティのドキュメント

animation : Animation [default]

このプロパティは、ビヘイビアがトリガーされたときに実行されるアニメーションを保持します。

enabled : bool

このプロパティは、トラッキングされたプロパティが値を変更したときに、ビヘイビアがトリガーされるかどうかを保持します。

デフォルトでは、ビヘイビアが有効になっています。

targetProperty group

このプロパティを使用すると、制御対象のプロパティの名前またはオブジェクトに基づいてカスタムビヘイビアを定義できます。

次の例では、Behaviorが制御するプロパティが変化すると、そのオブジェクトがフェードアウトしたりフェードインしたりするように定義しています：

// FadeBehavior.qml
import QtQuick 2.15

Behavior {
    id: root
    property Item fadeTarget: targetProperty.object
    SequentialAnimation {
        NumberAnimation {
            target: root.fadeTarget
            property: "opacity"
            to: 0
            easing.type: Easing.InQuad
        }
        PropertyAction { } // actually change the controlled property between the 2 other animations
        NumberAnimation {
            target: root.fadeTarget
            property: "opacity"
            to: 1
            easing.type: Easing.OutQuad
        }
    }
}

これは、テキストが変化したときにアニメーションさせるために使用できます：

import QtQuick 2.15

Text {
    id: root
    property int counter
    text: counter
    FadeBehavior on text {}
    Timer {
        running: true
        repeat: true
        interval: 1000
        onTriggered: ++root.counter
    }
}

これらのプロパティはQtQuick 2.15で導入されました。

targetValue : Variant [read-only, since QtQuick 2.13]

ビヘイビアが制御するプロパティのターゲット値を保持します。この値は、アニメーションを開始する前にBehaviorによって設定されます。

このプロパティは QtQuick 2.13 で導入されました。