Behavior QML Type
Define una animación predeterminada para un cambio de propiedad. Más información...
| Import Statement: | import QtQuick |
Propiedades
- animation : Animation
- enabled : bool
- targetProperty
(since QtQuick 2.15)- targetProperty.name : string
(since QtQuick 2.15) - targetProperty.object : QtObject
(since QtQuick 2.15)
- targetProperty.name : string
- targetValue : Variant
(since QtQuick 2.13)
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]
| Propiedad | Descripción |
|---|---|
| nombre | Esta propiedad contiene el nombre de la propiedad controlada por este comportamiento. |
| objeto | Esta 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.