C 语言
Q3DSDataInput 类
控制 Qt 3D Studio 演示中的数据输入项。此类是用于控制演示中数据输入的便利类。 DataInput 为演示设计与代码之间提供一个清晰的契约。它隐藏了演示的细节，同时提供了一个合同访问点，用于控制演示的各个方面（例如子演示的时间线）。它还允许设计使用单个 DataInput 来驱动设计的多个方面（例如，用于速度的 DataInput 可以改变速度表的颜色，表针的角度）。 更多信息...
此类是在 Qt 3D Studio 2.0 中引入的。
属性
公共函数
| Q3DSDataInput(Q3DSPresentation *presentation, const QString &name, QObject *parent = nullptr) | |
| virtual | ~Q3DSDataInput() |
| bool | isValid() const |
| float | 最大值() const |
| QString | 元数据(const QString &key) const |
| QStringList | 元数据密钥() const |
| float | 最小值() const |
| QString | 名称() const |
| QVariant | 值() const |
公共槽
信号
| void | nameChanged() |
| void | valueChanged() |
另请参阅：Q3DSPresentation::customSignalEmitted、Q3DSPresentation::slideEntered、Q3DSPresentation::slideExited、Q3DSDataOutput 和 Q3DSPresentation。
属性文档
最大值 : const float
包含数据输入的最大范围值。除 范围数字 之外的数据输入类型的返回值是零。
注意：此值为只读。
访问函数
| float | 最大值() const |
元数据密钥 : const QStringList
包含为此数据输入指定的元数据密钥。
注意：此值为只读。
访问函数
| QStringList | metadataKeys() const |
min : const float
包含数据输入的最小范围值。其他类型的 datainput 类型返回的值将为零。
注意：此值为只读。
访问函数
| float | min() const |
name : QString
指定演示中受控数据输入元素的名字。该名字必须匹配演示中定义的数据输入的名称。
在设置值属性之前必须设置此属性。初始值通过构造函数提供，但名字也可以稍后更改。
访问函数
| QString | name() const |
| void | setName(const QString &name) |
通知信号
| void | nameChanged() |
value : QVariant
指定演示中受控数据输入元素的值。
此属性的值仅针对通过同一 Q3DSDataInput 实例进行的更改。如果演示中相同数据输入的值在其他地方更改，例如通过动画或 Q3DSPresentation::setAttribute()，这些更改将不会反映在此属性的值中。
要获取演示的实际值，请使用 DataOutput。
访问函数
| QVariant | value() const |
| void | setValue(const QVariant &value, bool force = false) |
通知信号
| void | valueChanged() |
查看DataOutput。
成员函数文档
Q3DSDataInput::Q3DSDataInput(Q3DSPresentation *presentation, const QString &name, QObject *parent = nullptr)
构建一个 Q3DSDataInput 实例并初始化 name。构建的实例将自动与指定的 presentation 关联。可以指定一个可选的 parent 对象。
[slot] void Q3DSDataInput::setValue(const QVariant &value, bool force = false)
Q3DSDataInput::setValue 为此类数据输入设置新的 value。
setValue调用在单个帧周期内批处理。最近的设置的 value 将在帧周期结束时用于向运行时引擎提交更改事件。默认情况下，只有当新的 value 与上一帧提交的值实际不同时，才会创建更改事件。
使用 force 参数强制提交更改。在多个控制器更改目标元素属性的情况中，调用者可以确保值更改将被处理。请注意，动画优先于数据输入控制。
注意：出于性能原因，不要不必要地将 force 设置为 true 的方式调用 setValue。
注意：属性 value 的设置器函数。
查看value。
[virtual] Q3DSDataInput::~Q3DSDataInput()
析构函数。
bool Q3DSDataInput::isValid() const
如果与此数据输入关联的演示（或其子演示）具有具有匹配名称的数据输入定义，则返回 true。如果没有关联演示或未找到匹配项，则返回 false。
QString Q3DSDataInput::metadata(const QString &key) const
返回此数据输入定义的带有 key 元数据的元数据。
元数据是用户定义的键值表，可用于更好地描述用法或指示应绑定到此数据输入的外部数据源。元数据对演示渲染没有影响。
注意：数据输入元数据为只读。
注意：此函数可以通过元对象系统和 QML 调用。参见 Q_INVOKABLE。
QStringList Q3DSDataInput::metadataKeys() const
返回为此数据输入定义的元数据键。
注意：metadataKeys 属性的获取函数。
另请参阅：metadata。
在某些 Qt 许可证下可用。
了解更多信息。