\qmltype PropertyChanges \inqmlmodule QtQuick More...

Inheritance diagram for QQuickReplaceSignalHandler:

Collaboration diagram for QQuickReplaceSignalHandler:

Public Member Functions
	QQuickReplaceSignalHandler ()

	~QQuickReplaceSignalHandler ()

EventType	type () const override

void	execute () override

bool	isReversable () override

void	reverse () override

void	saveOriginals () override

bool	needsCopy () override

void	copyOriginals (QQuickStateActionEvent *other) override

void	rewind () override

void	saveCurrentValues () override

bool	mayOverride (QQuickStateActionEvent *other) override

Public Member Functions inherited from QQuickStateActionEvent
virtual	~QQuickStateActionEvent ()

virtual EventType	type () const =0

virtual void	execute ()

virtual bool	isReversable ()

virtual void	reverse ()

virtual void	saveOriginals ()

virtual bool	needsCopy ()

virtual void	copyOriginals (QQuickStateActionEvent *)

virtual bool	isRewindable ()

virtual void	rewind ()

virtual void	saveCurrentValues ()

virtual void	saveTargetValues ()

virtual bool	changesBindings ()

virtual void	clearBindings ()

virtual bool	mayOverride (QQuickStateActionEvent *other)

Public Attributes
QQmlProperty	property

QQmlRefPointer< QQmlBoundSignalExpression >	expression

QQmlRefPointer< QQmlBoundSignalExpression >	reverseExpression

QQmlRefPointer< QQmlBoundSignalExpression >	rewindExpression

Additional Inherited Members
Public Types inherited from QQuickStateActionEvent
enum	EventType { Script , SignalHandler , ParentChange , AnchorChanges }

Detailed Description

\qmltype PropertyChanges \inqmlmodule QtQuick

Describes new property bindings or values for a state.

PropertyChanges is used to define the property values or bindings in a \l State. This enables an item's property values to be changed when it \l {Qt Quick States}{changes between states}.

To create a PropertyChanges object, bind to properties of the target item like you would bind to local properties. This way you can define the new property values or bindings. For example:

import QtQuick

\codeline

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 {
               rect {
                   color: "blue"
                   height: container.height
               }
           }
        }
    }
}

When the mouse is pressed, the \l Rectangle changes to the resized state. In this state, the PropertyChanges object sets the rectangle's color to blue and the height value to that of container.height.

Note this automatically binds rect.height to container.height in the resized state. If a property binding should not be established, and the height should just be set to the value of container.height at the time of the state change, set the \l explicit property to true.

A PropertyChanges object can also override the default signal handler for an object to implement a signal handler specific to the new state:

\qml PropertyChanges { myMouseArea.onClicked: doSomethingDifferent() } \endqml

Note: PropertyChanges can be used to change anchor margins, but not other anchor values; use AnchorChanges for this instead. Similarly, to change an \l Item's \l {Item::}{parent} value, use ParentChange instead.

Definition at line 115 of file qquickpropertychanges.cpp.