Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
QQuickReplaceSignalHandler Class Reference

\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
 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 bool isRewindable ()
virtual void saveTargetValues ()
virtual bool changesBindings ()
virtual void clearBindings ()

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 118 of file qquickpropertychanges.cpp.

Constructor & Destructor Documentation

◆ QQuickReplaceSignalHandler() [1/2]

QQuickReplaceSignalHandler::QQuickReplaceSignalHandler ( )
inline

Definition at line 121 of file qquickpropertychanges.cpp.

◆ ~QQuickReplaceSignalHandler() [1/2]

QQuickReplaceSignalHandler::~QQuickReplaceSignalHandler ( )
inline

Definition at line 122 of file qquickpropertychanges.cpp.

◆ QQuickReplaceSignalHandler() [2/2]

QQuickReplaceSignalHandler::QQuickReplaceSignalHandler ( )
inline

Definition at line 121 of file qquickpropertychanges.cpp.

◆ ~QQuickReplaceSignalHandler() [2/2]

QQuickReplaceSignalHandler::~QQuickReplaceSignalHandler ( )
inline

Definition at line 122 of file qquickpropertychanges.cpp.

Member Function Documentation

◆ copyOriginals() [1/2]

void QQuickReplaceSignalHandler::copyOriginals ( QQuickStateActionEvent * other)
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 146 of file qquickpropertychanges.cpp.

References saveCurrentValues().

Here is the call graph for this function:

◆ copyOriginals() [2/2]

void QQuickReplaceSignalHandler::copyOriginals ( QQuickStateActionEvent * other)
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 146 of file qquickpropertychanges.cpp.

◆ execute() [1/2]

void QQuickReplaceSignalHandler::execute ( )
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 131 of file qquickpropertychanges.cpp.

◆ execute() [2/2]

void QQuickReplaceSignalHandler::execute ( )
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 131 of file qquickpropertychanges.cpp.

◆ isReversable() [1/2]

bool QQuickReplaceSignalHandler::isReversable ( )
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 135 of file qquickpropertychanges.cpp.

◆ isReversable() [2/2]

bool QQuickReplaceSignalHandler::isReversable ( )
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 135 of file qquickpropertychanges.cpp.

◆ mayOverride() [1/2]

bool QQuickReplaceSignalHandler::mayOverride ( QQuickStateActionEvent * other)
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 162 of file qquickpropertychanges.cpp.

◆ mayOverride() [2/2]

bool QQuickReplaceSignalHandler::mayOverride ( QQuickStateActionEvent * other)
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 162 of file qquickpropertychanges.cpp.

◆ needsCopy() [1/2]

bool QQuickReplaceSignalHandler::needsCopy ( )
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 145 of file qquickpropertychanges.cpp.

◆ needsCopy() [2/2]

bool QQuickReplaceSignalHandler::needsCopy ( )
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 145 of file qquickpropertychanges.cpp.

◆ reverse() [1/2]

void QQuickReplaceSignalHandler::reverse ( )
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 136 of file qquickpropertychanges.cpp.

◆ reverse() [2/2]

void QQuickReplaceSignalHandler::reverse ( )
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 136 of file qquickpropertychanges.cpp.

◆ rewind() [1/2]

void QQuickReplaceSignalHandler::rewind ( )
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 155 of file qquickpropertychanges.cpp.

◆ rewind() [2/2]

void QQuickReplaceSignalHandler::rewind ( )
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 155 of file qquickpropertychanges.cpp.

◆ saveCurrentValues() [1/2]

void QQuickReplaceSignalHandler::saveCurrentValues ( )
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 158 of file qquickpropertychanges.cpp.

Referenced by copyOriginals(), and saveOriginals().

Here is the caller graph for this function:

◆ saveCurrentValues() [2/2]

void QQuickReplaceSignalHandler::saveCurrentValues ( )
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 158 of file qquickpropertychanges.cpp.

◆ saveOriginals() [1/2]

void QQuickReplaceSignalHandler::saveOriginals ( )
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 140 of file qquickpropertychanges.cpp.

References saveCurrentValues().

Here is the call graph for this function:

◆ saveOriginals() [2/2]

void QQuickReplaceSignalHandler::saveOriginals ( )
inlineoverridevirtual

Reimplemented from QQuickStateActionEvent.

Definition at line 140 of file qquickpropertychanges.cpp.

◆ type() [1/2]

EventType QQuickReplaceSignalHandler::type ( ) const
inlineoverridevirtual

Implements QQuickStateActionEvent.

Definition at line 124 of file qquickpropertychanges.cpp.

◆ type() [2/2]

EventType QQuickReplaceSignalHandler::type ( ) const
inlineoverridevirtual

Implements QQuickStateActionEvent.

Definition at line 124 of file qquickpropertychanges.cpp.

Member Data Documentation

◆ expression

QQmlRefPointer< QQmlBoundSignalExpression > QQuickReplaceSignalHandler::expression

Definition at line 127 of file qquickpropertychanges.cpp.

◆ property

QQmlProperty QQuickReplaceSignalHandler::property

Definition at line 126 of file qquickpropertychanges.cpp.

◆ reverseExpression

QQmlRefPointer< QQmlBoundSignalExpression > QQuickReplaceSignalHandler::reverseExpression

Definition at line 128 of file qquickpropertychanges.cpp.

◆ rewindExpression

QQmlRefPointer< QQmlBoundSignalExpression > QQuickReplaceSignalHandler::rewindExpression

Definition at line 129 of file qquickpropertychanges.cpp.

The documentation for this class was generated from the following file: