blob: f025b29afec89cceefc73448e6d33835632cdb63 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
|
/****************************************************************************
**
** Copyright (C) 2020 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of Qt Quick Designer Components.
**
** $QT_BEGIN_LICENSE:GPL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3 or (at your option) any later version
** approved by the KDE Free Qt Foundation. The licenses are as published by
** the Free Software Foundation and appearing in the file LICENSE.GPL3
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-3.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/
import QtQuick 2.10
/*!
\qmltype BidirectionalBinding
\inqmlmodule QtQuick.Studio.LogicHelper
\since QtQuick.Studio.LogicHelper 1.0
\inherits QtObject
\brief Binds the values of two controls bi-directionally.
The BidirectionalBinding type binds the values of two controls
together, so that when one value is changed, the other one follows it.
For example, this type could be used to synchronize two sliders or a
slider and checkbox. Typically, it is used to bind a backend value to
a control, such as a slider.
The \l target01 and \l target02 properties specify the ids of the components
to bind together. The \l property01 and \l property02 properties specify the
names the properties to synchronize.
Designers can use the BidirectionalBinding type in \QDS instead of writing
JavaScript expressions.
A \l StringMapper type can be used to add a text property that displays the
value.
\section1 Example Usage
In the following example, we bind the values of two \l Slider types
together bidirectionally:
\code
Rectangle {
Slider {
id: slider
value: 0.5
}
Slider {
id: slider1
value: 0.5
}
BidrectionalBinding {
id: biDirectBinding
property02: "value"
property01: "value"
target02: slider1
target01: slider
}
}
\endcode
*/
QtObject {
id: object
/*!
The id of the component to bind to \l target02.
*/
property QtObject target01
/*!
The id of the component to bind to \l target01.
*/
property QtObject target02
/*!
The name of the property to synchronize with \l property02.
*/
property string property01
/*!
The name of the property to synchronize with \l property01.
*/
property string property02
property QtObject __internal: QtObject {
property variant value01
property variant value02
property bool block: false
onValue01Changed: {
if (__internal.block)
return;
__internal.block = true;
try {
object.target02[property02] = __internal.value01
} catch(error) {
}
__internal.block = false;
}
onValue02Changed: {
if (__internal.block)
return;
__internal.block = true;
try {
object.target01[property01] = __internal.value02
} catch(error) {
}
__internal.block = false;
}
}
property Binding __b01: Binding {
target: __internal
property: "value01"
value: target01[property01]
}
property Binding __b02: Binding {
target: __internal
property: "value02"
value: target02[property02]
}
}
/*##^##
Designer {
D{i:0;autoSize:true;height:480;width:640}
}
##^##*/
|
