Binding QML Type

允许任意创建属性绑定。更多

• 所有成员（包括继承成员）的列表

属性

• delayed : bool
• property : string
• restoreMode : enumeration
• target : QtObject
• value : var
• when : bool

详细说明

在 QML 中，属性绑定会导致不同对象的属性之间产生依赖关系。

绑定到不可访问的属性

有时需要把一个对象的属性绑定到另一个 QML 不能直接实例化的对象的属性上，如 C++ 导出到 QML 的类的属性。你可以使用绑定类型（Binding type）来建立这种依赖关系，把任何值绑定到任何对象的属性上。

例如，在映射 "app.enteredText" 属性到 QML 的 C++ 应用程序中，你可以使用 Binding 来更新 enteredText 属性。

TextEdit { id: myTextField; text: "Please type here..." }
Binding { app.enteredText: myTextField.text }

当text 发生变化时，C++ 属性enteredText 将自动更新。

条件绑定

在某些情况下，你可能想在满足特定条件时修改属性值，但在其他情况下则不修改。通常情况下，直接绑定无法做到这一点，因为您必须为所有可能的分支提供值。

例如，下面的代码段会在您释放鼠标时发出警告。这是因为当鼠标未按下时，绑定的值是未定义的。

// produces warning: "Unable to assign [undefined] to double value"
value: if (mouse.pressed) mouse.mouseX

绑定类型可以防止出现这种警告。

Binding on value {
    when: mouse.pressed
    value: mouse.mouseX
}

绑定类型可恢复先前在属性上设置的任何直接绑定。

另请参阅 Qt Qml.

属性文档

Binding {
    contactName.text.value: givenName + " " + familyName
    when: list.ListView.isCurrentItem
    delayed: true
}

Item {
    id: item

    property rect rectangle: Qt.rect(0, 0, 200, 200)
}

Binding {
    target: item
    property: "rectangle.x"
    value: 100
}

Binding { item.rectangle.x: 100 }

Binding { contactName.text: name }

Binding {
    target: contactName
    property: "text"
    value: name
}

Binding {
    contactName.text: name
    when: list.ListView.isCurrentItem
}