C

Q3DSSceneElement 类

控制 Qt 3D Studio 展示中的特殊场景或组件场景对象。 更多信息...

头文件 #include <Q3DSSceneElement>
Qt 3D Studio 2.0
实例化于 SceneElement
继承自 Q3DSElement

此类是从 Qt 3D Studio 2.0 中引入的。

属性

公共函数

Q3DSSceneElement(Q3DSPresentation *presentation, const QString &elementPath, QObject *parent = nullptr)
virtual~Q3DSSceneElement()
intcurrentSlideIndex() const
QStringcurrentSlideName() const
intpreviousSlideIndex() const
QStringpreviousSlideName() const

公共槽

voidgoToSlide(bool next, bool wrap)
voidgoToTime(float time)
voidsetCurrentSlideIndex(int currentSlideIndex)
voidsetCurrentSlideName(const QString &currentSlideName)

信号

voidcurrentSlideIndexChanged(int currentSlideIndex)
voidcurrentSlideNameChanged(const QString &currentSlideName)
voidpreviousSlideIndexChanged(int previousSlideIndex)
voidpreviousSlideNameChanged(const QString &previousSlideName)

详细描述

此类是一个方便类,用于控制场景中场景和组件对象的属性。它们是特殊的,因为它们具有时间上下文,意味着它们控制时间线和相关幻灯片集合。

注意:Q3DSSceneElement 的功能等同于 Q3DSPresentation::goToTime() 和 Q3DSPresentation::goToSlide

另请参阅Q3DSPresentationQ3DSSurfaceViewerQ3DSElement

属性文档

currentSlideIndex : int

包含跟踪时间上下文中当前活动幻灯片的索引。幻灯片索引从 1 开始。

注意:如果在 SceneElement 的初始声明中将此属性设置为非默认幻灯片,则在新幻灯片更改之前,默认幻灯片可能会发出更改信号。这是为了保证即使初始声明中指定的幻灯片无效,我们也能得到实际显示的幻灯片的索引。

访问函数

intcurrentSlideIndex() const
voidsetCurrentSlideIndex(int currentSlideIndex)

通知信号

voidcurrentSlideIndexChanged(int currentSlideIndex)

参阅:Q3DSPresentation::slideEntered

currentSlideName : QString

保存跟踪时间上下文当前活动幻灯片的名称。

注意:如果在 SceneElement 的初始声明中将此属性设置为非默认幻灯片,则在新幻灯片更改之前,默认幻灯片可能会发出更改信号。这是为了保证即使初始声明中指定的幻灯片无效,我们也能得到实际显示的幻灯片的索引。

访问函数

QStringcurrentSlideName() const
voidsetCurrentSlideName(const QString &currentSlideName)

通知信号

voidcurrentSlideNameChanged(const QString &currentSlideName)

previousSlideIndex : const int

保存跟踪时间上下文先前活动幻灯片的索引。

此属性为只读。

访问函数

intpreviousSlideIndex() const

通知信号

voidpreviousSlideIndexChanged(int previousSlideIndex)

previousSlideName : const QString

保存跟踪时间上下文先前活动幻灯片的名称。

此属性为只读。

访问函数

QStringpreviousSlideName() const

通知信号

voidpreviousSlideNameChanged(const QString &previousSlideName)

成员函数文档

Q3DSSceneElement::Q3DSSceneElement(Q3DSPresentation *presentation, const QString &elementPath, QObject *parent = nullptr)

构建 Q3DSSceneElement 实例并将其与由 elementPath 和给定的 presentation 指定的对象关联。可以指定可选的 parent 对象。

[slot] void Q3DSSceneElement::goToSlide(bool next, bool wrap)

根据 next 的值,请求时间上下文(Scene 或 Component 对象)更改到下一张或上一张幻灯片。如果上下文已处于最后一张或第一张幻灯片,wrap 将定义是否分别回调到第一张或最后一张幻灯片。

[slot] void Q3DSSceneElement::goToTime(float time)

将时间上下文(Scene 或 Component 元素)的时间线移动到特定位置。位置以 time 中的秒为单位提供。

[virtual] Q3DSSceneElement::~Q3DSSceneElement()

析构函数。

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