En esta página

PropertyAction QML Type

Especifica los cambios inmediatos en las propiedades durante la animación. Más...

Import Statement: import QtQuick
Inherits:

Animation

Propiedades

Descripción detallada

PropertyAction se utiliza para especificar un cambio inmediato en una propiedad durante una animación. El cambio en la propiedad no se anima.

Resulta útil para establecer valores de propiedad no animados durante una animación.

Por ejemplo, aquí hay un ` SequentialAnimation ` que establece la propiedad ` opacity ` de la imagen en ` .5`, anima el ancho de la imagen y, a continuación, vuelve a establecer ` opacity ` en ` 1`:

SequentialAnimation {
    PropertyAction { target: img; property: "opacity"; value: .5 }
    NumberAnimation { target: img; property: "width"; to: 300; duration: 1000 }
    PropertyAction { target: img; property: "opacity"; value: 1 }
}

PropertyAction también resulta útil para establecer el punto exacto en el que debe producirse un cambio de propiedad durante un « Transition ». Por ejemplo, si se utilizara « PropertyChanges » en un « State » para rotar un elemento alrededor de una « transformOrigin » concreta, se podría implementar así:

Item {
    width: 400; height: 400

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

        states: State {
            name: "rotated"
            PropertyChanges { target: rect; rotation: 180; transformOrigin: Item.BottomRight }
        }

        transitions: Transition {
            RotationAnimation { duration: 1000; direction: RotationAnimation.Counterclockwise }
        }

        MouseArea {
            anchors.fill: parent
            onClicked: rect.state = "rotated"
        }
    }
}

Sin embargo, con este código, la propiedad « transformOrigin » no se establece hasta después de la animación, ya que se utiliza un « State » para definir los valores al final de una transición. La animación giraría con el « transformOrigin » predeterminado y, a continuación, daría un salto a « Item.BottomRight ». Para solucionar esto, inserta una «PropertyAction» antes de que comience el « RotationAnimation »:

transitions: Transition {
    SequentialAnimation {
        PropertyAction { target: rect; property: "transformOrigin" }
        RotationAnimation { duration: 1000; direction: RotationAnimation.Counterclockwise }
    }
}

Esto establece inmediatamente la propiedad transformOrigin en el valor definido en el estado final de la Transition (es decir, el valor definido en el objeto PropertyAction), de modo que la animación de rotación comience con el origen de transformación correcto.

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

Documentación de propiedades

exclude : list<QtObject> [read-only]

Esta propiedad contiene los objetos que no deben verse afectados por esta acción.

Véase también « targets ».

properties : string

property : string

target : QtObject

targets : list<QtObject> [read-only]

Estas propiedades determinan los elementos y sus propiedades que se ven afectados por esta acción.

Los detalles sobre cómo se interpretan estas propiedades en diferentes situaciones se tratan en la documentación de « corresponding » ( PropertyAnimation ).

Véase también exclude.

value : var

Esta propiedad contiene el valor que se va a asignar a la propiedad.

Si la propiedad « PropertyAction » se define dentro de un « Transition » o un « Behavior », este valor se establece por defecto en el valor definido en el estado final del « Transition », o en el valor del cambio de propiedad que activó el « Behavior ».

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