Тип QML PropertyChanges

Описывает новые привязки свойств или значения для состояния. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• explicit : bool
• restoreEntryValues : bool
• target : Объект

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

PropertyChanges используется для определения значений или привязок свойств в Состоянии. Это позволяет изменять значения свойств элемента при переходе между состояниями.

Для создания объекта PropertyChanges укажите элемент target, свойства которого нужно изменить, и определите новые значения или привязки свойств. Например:

import QtQuick 2.0

Item {
    id: container
    width: 300; height: 300

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

        MouseArea {
           id: mouseArea
           anchors.fill: parent
        }

        states: State {
           name: "resized"; when: mouseArea.pressed
           PropertyChanges { target: rect; color: "blue"; height: container.height }
        }
    }
}

При нажатии мыши прямоугольник Rectangle переходит в состояние resized. В этом состоянии объект PropertyChanges устанавливает цвет прямоугольника в синий и значение height в значение container.height.

Обратите внимание, что это автоматически привязывает rect.height к container.height в состоянии resized. Если не нужно устанавливать привязку свойства, а необходимо просто установить высоту в значение container.height в момент перехода в состояние, установите свойство explicit в true.

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

PropertyChanges {
    target: myMouseArea
    onClicked: doSomethingDifferent()
}

Примечание: PropertyChanges можно использовать для изменения отступов якорей, но не других значений якорей; для этого используйте AnchorChanges. Аналогично, для изменения значения parent элемента Item используйте ParentChange.

Сброс значений свойств

Значение undefined можно использовать для сброса значения свойства для состояния. В следующем примере, когда myText переходит в состояние widerText, его свойство width сбрасывается, возвращая тексту значение естественной ширины и отображая всю строку на одной строке.

Rectangle {
    width: 300; height: 200

    Text {
        id: myText
        width: 50
        wrapMode: Text.WordWrap
        text: "a text string that is longer than 50 pixels"

        states: State {
            name: "widerText"
            PropertyChanges { target: myText; width: undefined }
        }
    }

    MouseArea {
        anchors.fill: parent
        onClicked: myText.state = "widerText"
    }
}

Непосредственные изменения свойств в переходах

При использовании Переходов для анимации изменений состояний, они анимируют свойства от их значений в текущем состоянии до значений, определенных в новом состоянии (как определено объектами PropertyChanges). Однако иногда желательно установить значение свойства непосредственно во время Перехода, без анимации; в этих случаях для принудительного изменения свойства можно использовать тип PropertyAction.

Дополнительные сведения см. в документации PropertyAction.

Примечание: Свойства visible и enabled элемента Item ведут себя не совсем так же, как и другие свойства в PropertyChanges. Поскольку эти свойства могут быть изменены неявно через состояние родителя, они должны быть установлены явно во всех объектах PropertyChanges. Элемент по-прежнему не будет включен/отображен, если один из его родителей не включен или не отображается.

См. также Пример состояний, Состояния Qt Quick и Qt QML.

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

explicit : bool

Если explicit установлено в true, любые потенциальные привязки будут интерпретироваться как однократные назначения, которые происходят при входе в состояние.

В следующем примере добавление explicit предотвращает привязку myItem.width к parent.width. Вместо этого ему присваивается значение parent.width в момент перехода в состояние.

PropertyChanges {
    target: myItem
    explicit: true
    width: parent.width
}

По умолчанию explicit равно false.

restoreEntryValues : bool

Это свойство указывает, должны ли предыдущие значения восстанавливаться при выходе из состояния.

Значение по умолчанию равно true. Установка этого значения в false создает временное состояние, которое оказывает постоянное влияние на значения свойств.

target : Объект

Это свойство содержит объект, содержащий свойства, которые нужно изменить.