En esta página

Behavior QML Type

Define una animación predeterminada para un cambio de propiedad. Más información...

Import Statement: import QtQuick

Propiedades

Descripción detallada

Un «Comportamiento» define la animación predeterminada que se aplicará cada vez que cambie el valor de una propiedad concreta.

Por ejemplo, el siguiente «Behavior» define que se ejecute « NumberAnimation » cada vez que cambie el valor de « width » de « Rectangle ». Al hacer clic en « MouseArea », se modifica « width », lo que activa la animación del «Behavior»:

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
    }
}

Ten en cuenta que una propiedad no puede tener más de un comportamiento asignado. Para proporcionar varias animaciones dentro de un comportamiento, utiliza ParallelAnimation o SequentialAnimation.

Si un cambio de estado tiene un « Transition » que coincide con la misma propiedad que un «Behavior», la animación del « Transition » anula el «Behavior» para ese cambio de estado. Para obtener consejos generales sobre el uso de «Behaviors» para animar cambios de estado, consulta «Uso de « Qt Quick » Behaviors con estados».

Véase también «Animación y transiciones en Qt Quick », «Ejemplo de comportamiento» y Qt Qml.

Documentación de propiedades

animation : Animation [default]

Esta propiedad contiene la animación que se ejecutará cuando se active el comportamiento.

enabled : bool

Esta propiedad determina si el comportamiento se activará cuando la propiedad rastreada cambie de valor.

Por defecto, un comportamiento está activado.

targetProperty group

targetProperty.name : string [read-only, since QtQuick 2.15]

targetProperty.object : QtObject [read-only, since QtQuick 2.15]

PropiedadDescripción
nombreEsta propiedad contiene el nombre de la propiedad controlada por este comportamiento.
objetoEsta propiedad contiene el objeto de la propiedad controlada por este comportamiento.

Esta propiedad se puede utilizar para definir comportamientos personalizados basados en el nombre o el objeto de la propiedad que se está controlando.

El siguiente ejemplo define un comportamiento que hace que el objeto de destino aparezca y desaparezca gradualmente cuando cambia la propiedad que controla:

// 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
        }
    }
}

Esto se puede utilizar para animar un texto cuando cambia:

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
    }
}

Estas propiedades se introdujeron en QtQuick 2.15.

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

Esta propiedad contiene el valor de destino de la propiedad controlada por el comportamiento. El comportamiento establece este valor antes de que se inicie la animación.

Esta propiedad se introdujo en QtQuick 2.13.

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