C

数据输入 QML 类型

控制 Qt 3D Studio 展示中的数据输入项。 更多...

导入语句import QtStudio3D.OpenGL 2.8
实例化 Q3DSDataInput

属性

方法

详细介绍

此类是一个用于控制展示中数据输入的便利类。数据输入提供了一个干净的设计和代码之间的合约。它隐藏了展示细节，同时提供了对代码的合约访问点以控制展示的各个部分（例如子展示的时间线）。它还允许设计使用单个数据输入驱动设计的多个方面（例如，用于速度的数据输入可以改变速度计的颜色，指针的角度）。

例如

Studio3D {
    ...
    Presentation {
        id: presentation
        ...
        property string text: ""
        DataInput {
            name: "inputForSomeTextNode"
            value: presentation.text
        }
    }
}

Button {
    onClicked: presentation.text = "Hello World"
}

此示例假设在 Qt 3D Studio 展示中使用了 Qt 3D Studio 编辑器，在目标属性的 textstring 属性和数据输入名称 inputForSomeTextNode 之间建立了数据输入连接。由于值现在通过属性设置，因此可以使用完整的 QML 属性绑定技术。

注意：为每个注册的数据输入都会产生性能开销，因此请尽量避免创建不必要的数据输入。

另请参阅：展示、数据输出、展示.slideExited()、展示.slideEntered() 和 展示.customSignalEmitted()。

属性文档

max : real

包含受控数据输入元素范围的最高值。

此属性仅适用于数据输入类型 范围数字。对于其他类型，返回的值为零。

注意：此值是只读的。


metadataKeys : list<string>

包含为此数据输入指定的元数据键。

注意：此值是只读的。


min : real

包含受控数据输入元素范围的最小值。

此属性仅适用于数据输入类型 范围数字。对于其他类型，返回的值为零。

注意：此值是只读的。


name : string

指定呈现中受控制的数据输入元素的名称。该名称必须与呈现中定义的数据输入的名称相匹配。必须在设置值属性之前设置此属性。


value : variant

指定呈现中受控制数据输入元素的值。

此属性的值仅计算通过相同的Q3DSDataInput实例所做的更改。如果呈现中相同数据输入的值在其他地方更改，例如通过动画或Q3DSPresentation::setAttribute()，则这些更改不会反映在此属性的值中。

要从呈现中获取实际值，请使用DataOutput。

另请参阅DataOutput。


方法文档

string metadata(string keys)

返回为此数据输入定义的与元数据键 keys 相关的元数据。

元数据是用户自定义的键值表，可用于例如更好地描述数据输入的使用或指出应绑定对此数据输入的外部数据源。元数据对呈现渲染没有影响。

注意：数据输入元数据为只读。


list<string> metadataKeys()

包含为此数据输入指定的元数据键。


在特定Qt许可下可用。
了解更多。