Spec-Zone.ru › Qt 5.9

Тип QML PropertyAnimation

Анимирует изменения значений свойств Подробнее...

Заявление об импорте: import QtQuick 2.7
Наследует:

Animation
Наследует от:

ColorAnimation, CoordinateAnimation, NumberAnimation, QuaternionAnimation, RotationAnimation и Vector3dAnimation
  • Список всех членов, включая наследуемые члены

Свойства

  • duration : int
  • easing
    • easing.type : перечисление
    • easing.amplitude : вещественное
    • easing.overshoot : вещественное
    • easing.period : вещественное
    • easing.bezierCurve : список<вещественное>
  • exclude : список<Объект>
  • from : вариант
  • properties : строка
  • property : строка
  • target : Объект
  • targets : список<Объект>
  • to : вариант

Подробное описание

PropertyAnimation предоставляет способ анимировать изменения значения свойства.

Его можно использовать для определения анимации различными способами:

  • В Переходе

    Например, для анимации любых объектов, которые изменили свои x или y свойства в результате изменения состояния, используя кривую сглаживания InOutQuad:

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

    states: State {
        name: "moved"
        PropertyChanges { target: rect; x: 50 }
    }

    transitions: Transition {
        PropertyAnimation { properties: "x,y"; easing.type: Easing.InOutQuad }
    }
}
  • В Поведении

    Например, для анимации всех изменений свойства x прямоугольника:

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

    Behavior on x { PropertyAnimation {} }

    MouseArea { anchors.fill: parent; onClicked: parent.x = 50 }
}
  • В качестве источника значения свойства

    Например, для многократной анимации свойства x прямоугольника:

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

    SequentialAnimation on x {
        loops: Animation.Infinite
        PropertyAnimation { to: 50 }
        PropertyAnimation { to: 0 }
    }
}
  • В обработчике сигнала

    Например, для плавного затемнения theObject при нажатии:

    MouseArea {
    anchors.fill: theObject
    onClicked: PropertyAnimation { target: theObject; property: "opacity"; to: 0 }
}
  • Самостоятельно

    Например, для анимации свойства rect width ширины в течение 500 мс, от текущей ширины до 30:

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

    // this is a standalone animation, it's not running by default
    PropertyAnimation { id: animation;
                        target: theRect;
                        property: "width";
                        to: 30;
                        duration: 500 }

    MouseArea { anchors.fill: parent; onClicked: animation.running = true }
}

В зависимости от способа использования анимации, набор используемых свойств будет отличаться. Для получения дополнительной информации см. документацию по отдельным свойствам, а также введение Анимация и переходы в Qt Quick.

Обратите внимание, что PropertyAnimation наследует абстрактный тип Animation. Это включает дополнительные свойства и методы для управления анимацией.

См. также Анимация и переходы в Qt Quick и Примеры Qt Quick - Анимация.

Документация по свойствам

duration : int

Это свойство хранит продолжительность анимации в миллисекундах.

Значение по умолчанию равно 250.

easing.type : перечисление

Указывает кривую сглаживания, используемую для анимации.

Для задания кривой сглаживания необходимо указать, по крайней мере, тип. Для некоторых кривых вы также можете указать амплитуду, период и/или перескок (более подробная информация приведена после таблицы). Кривая сглаживания по умолчанию - Easing.Linear.

PropertyAnimation { properties: "y";
                    easing.type: Easing.InOutElastic;
                    easing.amplitude: 2.0;
                    easing.period: 1.5 }

Доступные типы:

Easing.Linear Кривая сглаживания для линейной (t) функции: скорость постоянна.
Easing.InQuad Кривая сглаживания для квадратичной (t^2) функции: ускорение от нулевой скорости.
Easing.OutQuad Кривая сглаживания для квадратичной (t^2) функции: замедление до нулевой скорости.
Easing.InOutQuad Кривая сглаживания для квадратичной (t^2) функции: ускорение до середины, затем замедление.
Easing.OutInQuad Кривая сглаживания для квадратичной (t^2) функции: замедление до середины, затем ускорение.
Easing.InCubic Кривая сглаживания для кубической (t^3) функции: ускорение от нулевой скорости.
Easing.OutCubic Кривая сглаживания для кубической (t^3) функции: замедление до нулевой скорости.
Easing.InOutCubic Кривая сглаживания для кубической (t^3) функции: ускорение до середины, затем замедление.
Easing.OutInCubic Кривая сглаживания для кубической (t^3) функции: замедление до середины, затем ускорение.
Easing.InQuart Кривая сглаживания для четвёртой степени (t^4) функции: ускорение от нулевой скорости.
Easing.OutQuart Кривая сглаживания для четвёртой степени (t^4) функции: замедление до нулевой скорости.
Easing.InOutQuart Кривая сглаживания для четвёртой степени (t^4) функции: ускорение до середины, затем замедление.
Easing.OutInQuart Кривая сглаживания для четвёртой степени (t^4) функции: замедление до середины, затем ускорение.
Easing.InQuint Кривая сглаживания для пятой степени (t^5) функции: ускорение от нулевой скорости.
Easing.OutQuint Кривая сглаживания для пятой степени (t^5) функции: замедление до нулевой скорости.
Easing.InOutQuint Кривая сглаживания для пятой степени (t^5) функции: ускорение до середины, затем замедление.
Easing.OutInQuint Кривая сглаживания для пятой степени (t^5) функции: замедление до середины, затем ускорение.
Easing.InSine Кривая сглаживания для синусоидальной (sin(t)) функции: ускорение от нулевой скорости.
Easing.OutSine Кривая сглаживания для синусоидальной (sin(t)) функции: замедление до нулевой скорости.
Easing.InOutSine Кривая сглаживания для синусоидальной (sin(t)) функции: ускорение до середины, затем замедление.
Easing.OutInSine Кривая сглаживания для синусоидальной (sin(t)) функции: замедление до середины, затем ускорение.
Easing.InExpo Кривая сглаживания для экспоненциальной (2^t) функции: ускорение от нулевой скорости.
Easing.OutExpo Кривая сглаживания для экспоненциальной (2^t) функции: замедление до нулевой скорости.
Easing.InOutExpo Кривая сглаживания для экспоненциальной (2^t) функции: ускорение до середины, затем замедление.
Easing.OutInExpo Кривая сглаживания для экспоненциальной (2^t) функции: замедление до середины, затем ускорение.
Easing.InCirc Кривая сглаживания для круговой (sqrt(1-t^2)) функции: ускорение от нулевой скорости.
Easing.OutCirc Кривая сглаживания для круговой (sqrt(1-t^2)) функции: замедление до нулевой скорости.
Easing.InOutCirc Кривая сглаживания для круговой (sqrt(1-t^2)) функции: ускорение до середины, затем замедление.
Easing.OutInCirc Кривая сглаживания для круговой (sqrt(1-t^2)) функции: замедление до середины, затем ускорение.
Easing.InElastic Кривая сглаживания для упругой (экспоненциально убывающая синусоидальная волна) функции: ускорение от нулевой скорости. Пиковая амплитуда может быть установлена параметром amplitude, а период затухания — параметром period.
Easing.OutElastic Кривая сглаживания для упругой (экспоненциально убывающая синусоидальная волна) функции: замедление до нулевой скорости. Пиковая амплитуда может быть установлена параметром amplitude, а период затухания — параметром period.
Easing.InOutElastic Кривая сглаживания для упругой (экспоненциально убывающая синусоидальная волна) функции: ускорение до середины, затем замедление.
Easing.OutInElastic Кривая сглаживания для упругой (экспоненциально убывающая синусоидальная волна) функции: замедление до середины, затем ускорение.
Easing.InBack Кривая сглаживания для обратной (пересекающая кубическая функция: (s+1)*t^3 - s*t^2) входящая: ускорение от нулевой скорости.
Easing.OutBack Кривая сглаживания для обратной (пересекающая кубическая функция: (s+1)*t^3 - s*t^2) исходящая: замедление до нулевой скорости.
Easing.InOutBack Кривая сглаживания для обратной (пересекающая кубическая функция: (s+1)*t^3 - s*t^2) входящая/исходящая: ускорение до середины, затем замедление.
Easing.OutInBack Кривая сглаживания для обратной (пересекающая кубическая сглаживание: (s+1)*t^3 - s*t^2) исходящая/входящая: замедление до середины, затем ускорение.
Easing.InBounce Кривая сглаживания для отскока (экспоненциально убывающее параболическое отражение) функция: ускорение от нулевой скорости.
Easing.OutBounce Кривая сглаживания для отскока (экспоненциально убывающее параболическое отражение) функция: замедление до нулевой скорости.
Easing.InOutBounce Кривая сглаживания для отскока (экспоненциально убывающее параболическое отражение) функция входящая/исходящая: ускорение до середины, затем замедление.
Easing.OutInBounce Кривая сглаживания для отскока (экспоненциально убывающее параболическое отражение) функция исходящая/входящая: замедление до середины, затем ускорение.
Easing.Bezier Пользовательская кривая сглаживания, определённая свойством easing.bezierCurve.

easing.amplitude применяется только для кривых отскока и упругих кривых (кривые типа Easing.InBounce, Easing.OutBounce, Easing.InOutBounce, Easing.OutInBounce, Easing.InElastic, Easing.OutElastic, Easing.InOutElastic или Easing.OutInElastic).

easing.overshoot применима только если easing.type равно: Easing.InBack, Easing.OutBack, Easing.InOutBack или Easing.OutInBack.

easing.period применима только если easing.type равно: Easing.InElastic, Easing.OutElastic, Easing.InOutElastic или Easing.OutInElastic.

easing.bezierCurve применима только если easing.type равно: Easing.Bezier. Это свойство — список<вещественные> содержащий группы из трёх точек, определяющих кривую от 0,0 до 1,1 — контрольная точка 1, контрольная точка 2, конечная точка: [cx1, cy1, cx2, cy2, endx, endy, ...]. Последняя точка должна быть 1,1.

См. Кривые сглаживания для демонстрации различных настроек сглаживания.

exclude : list<Object>

Это свойство содержит элементы, на которые не должно влиять данное анимационное действие.

См. также PropertyAnimation::targets.

from : variant

Это свойство содержит начальное значение для анимации.

Если PropertyAnimation определён в Transition или Behavior, это значение по умолчанию равно значению, определённому в начальном состоянии Transition, или текущему значению свойства в момент запуска Behavior.

См. также Анимация и переходы в Qt Quick.

properties : string

Эти свойства используются как набор для определения свойств, которые должны быть анимированы. Единичная и множественная формы функционально идентичны, например:

NumberAnimation { target: theItem; property: "x"; to: 500 }

имеет тот же смысл, что и

NumberAnimation { targets: theItem; properties: "x"; to: 500 }

Единичные формы немного оптимизированы, поэтому если вы анимируете только один целевой объект/свойство, рекомендуется использовать их.

Свойство targets позволяет задать несколько целевых объектов. Например, это анимирует свойство x как для itemA, так и для itemB:

NumberAnimation { targets: [itemA, itemB]; properties: "x"; to: 500 }

Во многих случаях эти свойства не нужно явно указывать, так как их можно вывести из фреймворка анимации:

Источник значения / Поведение При использовании анимации в качестве источника значения или в поведении, целевой объект и имя свойства, подлежащие анимации, могут быть определены по умолчанию.
Rectangle {
    id: theRect
    width: 100; height: 100
    color: Qt.rgba(0,0,1)
    NumberAnimation on x { to: 500; loops: Animation.Infinite } //animate theRect's x property
    Behavior on y { NumberAnimation {} } //animate theRect's y property
}
Переход При использовании в переходе предполагается, что анимация свойства соответствует всем целевым объектам, но не свойствам. На практике это означает, что вам необходимо указать хотя бы свойства, чтобы анимация работала.
Rectangle {
    id: theRect
    width: 100; height: 100
    color: Qt.rgba(0,0,1)
    Item { id: uselessItem }
    states: State {
        name: "state1"
        PropertyChanges { target: theRect; x: 200; y: 200; z: 4 }
        PropertyChanges { target: uselessItem; x: 10; y: 10; z: 2 }
    }
    transitions: Transition {
        //animate both theRect's and uselessItem's x and y to their final values
        NumberAnimation { properties: "x,y" }

        //animate theRect's z to its final value
        NumberAnimation { target: theRect; property: "z" }
    }
}
Отдельно При использовании анимации отдельно, и целевой объект, и свойство необходимо указать явно.
Rectangle {
    id: theRect
    width: 100; height: 100
    color: Qt.rgba(0,0,1)
    //need to explicitly specify target and property
    NumberAnimation { id: theAnim; target: theRect; property: "x"; to: 500 }
    MouseArea {
        anchors.fill: parent
        onClicked: theAnim.start()
    }
}

Как видно из примера выше, свойства задаются в виде строки с именами свойств, разделенных запятыми, которые подлежат анимации.

См. также exclude и Анимация и переходы в Qt Quick.

property : string

Эти свойства используются как набор для определения, какие свойства должны быть анимированы. Единичная и множественная формы функционально идентичны, например:

NumberAnimation { target: theItem; property: "x"; to: 500 }

имеет тот же смысл, что и

NumberAnimation { targets: theItem; properties: "x"; to: 500 }

Единичные формы немного оптимизированы, поэтому, если вам нужно анимировать только один целевой объект/свойство, рекомендуется использовать их.

Свойство targets позволяет задавать несколько целевых объектов. Например, это анимирует свойство x как для itemA, так и для itemB:

NumberAnimation { targets: [itemA, itemB]; properties: "x"; to: 500 }

Во многих случаях эти свойства не нужно явно указывать, так как их можно вывести из фреймворка анимации:

Источник значения / Поведение При использовании анимации в качестве источника значения или в поведении, целевой объект и имя свойства, подлежащие анимации, могут быть определены по умолчанию.
Rectangle {
    id: theRect
    width: 100; height: 100
    color: Qt.rgba(0,0,1)
    NumberAnimation on x { to: 500; loops: Animation.Infinite } //animate theRect's x property
    Behavior on y { NumberAnimation {} } //animate theRect's y property
}
Переход При использовании в переходе предполагается, что анимация свойства соответствует всем целевым объектам, но не свойствам. На практике это означает, что вам необходимо указать хотя бы свойства, чтобы анимация работала.
Rectangle {
    id: theRect
    width: 100; height: 100
    color: Qt.rgba(0,0,1)
    Item { id: uselessItem }
    states: State {
        name: "state1"
        PropertyChanges { target: theRect; x: 200; y: 200; z: 4 }
        PropertyChanges { target: uselessItem; x: 10; y: 10; z: 2 }
    }
    transitions: Transition {
        //animate both theRect's and uselessItem's x and y to their final values
        NumberAnimation { properties: "x,y" }

        //animate theRect's z to its final value
        NumberAnimation { target: theRect; property: "z" }
    }
}
Отдельно При использовании анимации отдельно, и целевой объект, и свойство необходимо указать явно.
Rectangle {
    id: theRect
    width: 100; height: 100
    color: Qt.rgba(0,0,1)
    //need to explicitly specify target and property
    NumberAnimation { id: theAnim; target: theRect; property: "x"; to: 500 }
    MouseArea {
        anchors.fill: parent
        onClicked: theAnim.start()
    }
}

Как видно из примера выше, свойства задаются в виде строки с именами свойств, разделенных запятыми, которые подлежат анимации.

См. также exclude и Анимация и переходы в Qt Quick.

target : Object

Эти свойства используются как набор для определения, какие свойства должны быть анимированы. Единичная и множественная формы функционально идентичны, например:

NumberAnimation { target: theItem; property: "x"; to: 500 }

имеет тот же смысл, что и

NumberAnimation { targets: theItem; properties: "x"; to: 500 }

Единичные формы немного оптимизированы, поэтому, если вам нужно анимировать только один целевой объект/свойство, рекомендуется использовать их.

Свойство targets позволяет задавать несколько целевых объектов. Например, это анимирует свойство x как для itemA, так и для itemB:

NumberAnimation { targets: [itemA, itemB]; properties: "x"; to: 500 }

Во многих случаях эти свойства не нужно явно указывать, так как их можно вывести из фреймворка анимации:

Источник значения / Поведение При использовании анимации в качестве источника значения или в поведении, целевой объект и имя свойства, подлежащие анимации, могут быть определены по умолчанию.
Rectangle {
    id: theRect
    width: 100; height: 100
    color: Qt.rgba(0,0,1)
    NumberAnimation on x { to: 500; loops: Animation.Infinite } //animate theRect's x property
    Behavior on y { NumberAnimation {} } //animate theRect's y property
}
Переход При использовании в переходе предполагается, что анимация свойства соответствует всем целевым объектам, но не свойствам. На практике это означает, что вам необходимо указать хотя бы свойства, чтобы анимация работала.
Rectangle {
    id: theRect
    width: 100; height: 100
    color: Qt.rgba(0,0,1)
    Item { id: uselessItem }
    states: State {
        name: "state1"
        PropertyChanges { target: theRect; x: 200; y: 200; z: 4 }
        PropertyChanges { target: uselessItem; x: 10; y: 10; z: 2 }
    }
    transitions: Transition {
        //animate both theRect's and uselessItem's x and y to their final values
        NumberAnimation { properties: "x,y" }

        //animate theRect's z to its final value
        NumberAnimation { target: theRect; property: "z" }
    }
}
Отдельно При использовании анимации отдельно, и целевой объект, и свойство необходимо указать явно.
Rectangle {
    id: theRect
    width: 100; height: 100
    color: Qt.rgba(0,0,1)
    //need to explicitly specify target and property
    NumberAnimation { id: theAnim; target: theRect; property: "x"; to: 500 }
    MouseArea {
        anchors.fill: parent
        onClicked: theAnim.start()
    }
}

Как видно из примера выше, свойства задаются в виде строки с именами свойств, разделенных запятыми, которые подлежат анимации.

См. также exclude и Анимация и переходы в Qt Quick.

targets : list<Object>

Эти свойства используются как набор для определения, какие свойства должны быть анимированы. Единичная и множественная формы функционально идентичны, например:

NumberAnimation { target: theItem; property: "x"; to: 500 }

имеет тот же смысл, что и

NumberAnimation { targets: theItem; properties: "x"; to: 500 }

Единичные формы немного оптимизированы, поэтому, если вам нужно анимировать только один целевой объект/свойство, рекомендуется использовать их.

Свойство targets позволяет задавать несколько целевых объектов. Например, это анимирует свойство x как для itemA, так и для itemB:

NumberAnimation { targets: [itemA, itemB]; properties: "x"; to: 500 }

Во многих случаях эти свойства не нужно явно указывать, так как их можно вывести из фреймворка анимации:

Источник значения / Поведение При использовании анимации в качестве источника значения или в поведении, целевой объект и имя свойства, подлежащие анимации, могут быть определены по умолчанию.
Rectangle {
    id: theRect
    width: 100; height: 100
    color: Qt.rgba(0,0,1)
    NumberAnimation on x { to: 500; loops: Animation.Infinite } //animate theRect's x property
    Behavior on y { NumberAnimation {} } //animate theRect's y property
}
Переход При использовании в переходе предполагается, что анимация свойства соответствует всем целевым объектам, но не свойствам. На практике это означает, что вам необходимо указать хотя бы свойства, чтобы анимация работала.
Rectangle {
    id: theRect
    width: 100; height: 100
    color: Qt.rgba(0,0,1)
    Item { id: uselessItem }
    states: State {
        name: "state1"
        PropertyChanges { target: theRect; x: 200; y: 200; z: 4 }
        PropertyChanges { target: uselessItem; x: 10; y: 10; z: 2 }
    }
    transitions: Transition {
        //animate both theRect's and uselessItem's x and y to their final values
        NumberAnimation { properties: "x,y" }

        //animate theRect's z to its final value
        NumberAnimation { target: theRect; property: "z" }
    }
}
Отдельно При использовании анимации отдельно, и целевой объект, и свойство необходимо указать явно.
Rectangle {
    id: theRect
    width: 100; height: 100
    color: Qt.rgba(0,0,1)
    //need to explicitly specify target and property
    NumberAnimation { id: theAnim; target: theRect; property: "x"; to: 500 }
    MouseArea {
        anchors.fill: parent
        onClicked: theAnim.start()
    }
}

Как видно из примера выше, свойства задаются в виде строки с именами свойств, разделенных запятыми, которые подлежат анимации.

См. также exclude и Анимация и переходы в Qt Quick.

to : variant

Это свойство содержит конечное значение для анимации.

Если PropertyAnimation определен в рамках Перехода или Поведения, это значение по умолчанию равно значению, определенному в конечном состоянии Перехода, или значению изменения свойства, которое вызвало Поведение.

См. также Анимация и переходы в Qt Quick.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qml-qtquick-propertyanimation.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API