成员函数文档

StateManager::StateManager(SafeRenderer::AbstractWindow &window, SafeRenderer::QSafeLayout &layout, const SafeRenderer::ARGB clearColorArg = ARGB())

使用给定的window帧缓冲区、layout默认布局和clearColorArg清除颜色值构建一个 StateManager 对像。

如果失败，将抛出以下异常之一

void StateManager::addLayout(SafeRenderer::QSafeLayout *const layout)

向状态管理器添加新的layout。在此过程中，布局尚未投入使用。每个QSafeLayout实例都有一个唯一的ID，它是布局文件哈希值。此值用于QSafeEventChangeLayout事件在请求布局更改时。

如果失败，将抛出以下异常之一

void StateManager::advanceAnimations()

如果有过渡进行中，则推进动画。此函数应由动画计时器调用。如果没有进行过渡，此函数不执行任何操作。

void StateManager::connect(const SafeRenderer::quint32 eventArg, const SafeRenderer::qchar *const stateName)

将外部eventArg连接到stateName布局项目。 stateName是QML中安全项目的objectName。

如果失败，将抛出以下异常之一

QML定义的示例

SafePicture {
    id: iconCoolant
    objectName: "iconCoolant"
    width: 30
    height: 30
    color: "#e41e25"
    source: "qrc:/iso-icons/iso_grs_7000_4_2426.dat"
}

您可以按照以下方式将外部事件EventEngineTemperature连接到iconCoolant项目

stateManager.connect(SafeRenderer::EventEngineTemperature, "iconCoolant");

void StateManager::connect(const SafeRenderer::quint32 eventArg, const SafeRenderer::quint32 stateIdArg)

将外部 eventArg 连接到 stateIdArg 布局项。 stateIdArg 是 QML 中安全项目 objectName 计算出的哈希值。

如果失败，将抛出以下异常之一

SafeRenderer::quint32 StateManager::getItemAtPosition(const SafeRenderer::quint32 xArg, const SafeRenderer::quint32 yArg) const

返回 xArg 和 yArg 位置的项目 ID。如果同一位置有多个项目，则返回最上面的可视项目。如果没有可见项目在该位置，则返回 0。

此函数在 QtSafeRenderer 2.0 中引入。

SafeRenderer::quint32 StateManager::getItemState(const SafeRenderer::quint32 itemIdArg) const

返回 itemIdArg 的状态。

SafeRenderer::quint32 StateManager::getLayout() const

返回活动布局的 ID。

const SafeRenderer::LayoutData &StateManager::getLayoutItem(const SafeRenderer::quint32 idArg) const

返回由 idArg 标识的 SafeRenderer::LayoutData 项。

void StateManager::handleConnection(const SafeRenderer::QSafeEventSystem &eventArg)

处理可以将其相关状态在开和关之间切换的 eventArg。

如果失败，将抛出以下异常之一

void StateManager::handleEvent(const SafeRenderer::QSafeEvent &eventArg)

处理 eventArg 事件。有关事件的信息，请参阅 QSafeEvent 类。

如果失败，将抛出以下异常之一

bool StateManager::isInTransition() const

如果有过渡正在进行，则返回 true，否则返回 false。

bool StateManager::isItemInTransition(const SafeRenderer::quint32 itemIdArg) const

如果项目 itemIdArg 在过渡中，则返回 true，否则返回 false。

bool StateManager::setLayout(SafeRenderer::QSafeLayout *const layout)

将 StateManager 的当前布局更改为 layout。

如果布局更改成功，则返回 true，否则返回 false。

如果失败，将抛出以下异常之一