操作和消息参考¶
您可以在这里找到在 Kanzi Studio 中可与触发器一起使用的操作的参考。要了解触发器,请参阅 使用触发器。
Activity Host actions¶
使用 Activity Host 操作设置活动主机以激活或停用特定活动。
名称 (Name) |
描述 (Description) |
|---|---|
Activate Activity |
激活您在此操作中设置的子 Activity。成功激活后,Exclusive Activity Host 会自动停用先前活动的 Activity。 |
Deactivate Activity |
停用您在此操作中设置的子 Activity。您只能使用此操作来停用 Parallel Activity Host 中的 Activity。 |
要了解使用 Activities 和 Activity Hosts,请参阅:
应用操作¶
当您想将一个值应用于属性或仅在 Data Trigger 中的条件表达式计算为 true 时激活 Activity 节点时,使用 Apply 操作。当该 Data Trigger 中的条件表达式不再计算为 true 时,Kanzi 会恢复您在 Apply 操作中设置的更改。
您只能在 Data Trigger 中使用 Apply 操作。
名称 (Name) |
描述 (Description) |
|---|---|
Apply Activation Action |
在包含此操作的触发器中,只要条件表达式满足,就保持 Activity 节点激活。当触发器条件表达式不再满足时,Kanzi 将 Activity 节点的状态回滚到应用操作之前的状态。请参阅 使用 Apply Activation Action 激活活动。 |
Apply Property Action |
将属性设置为请求的值,只要触发此操作的条件表达式满足。当触发条件表达式不再满足时,Kanzi 将该属性的值回滚到应用此操作之前的值,或回滚到 Kanzi 应用此操作时设置的值。 |
要了解数据触发器,请参阅 数据触发器。
要了解 Activity 节点,请参阅 活动。
Animation Player actions¶
使用 Animation Player 操作来控制应用程序中动画的播放。
名称 (Name) |
描述 (Description) |
|---|---|
Pause |
暂停正在运行的动画。 |
Resume |
恢复动画。 |
Start |
启动动画。 |
Stop |
停止正在运行的动画。 |
要了解动画操作,请参阅 使用关键帧动画。
独占活动主机操作¶
使用 Exclusive Activity Host 操作设置活动主机以导航到活动。
名称 (Name) |
描述 (Description) |
|---|---|
Navigate To Next Activity |
导航到 Exclusive Activity Host 中的下一个 Activity。 |
Navigate To Previous Activity |
导航到 Exclusive Activity Host 中的上一个 Activity。 |
要了解使用 Activities 和 Activity Hosts,请参阅:
焦点动作¶
使用 Focus 操作将应用程序设置为将焦点设置到一个节点或在焦点链中移动焦点。
名称 (Name) |
描述 (Description) |
|---|---|
Move Focus |
将焦点移动到您在此操作中设置的焦点链方向中的下一个可聚焦节点。 |
Focus > Move Scope Focus Forward |
将焦点移动到您在此操作中设置的焦点范围节点内的下一个可聚焦节点的前进方向。 |
Focus > Move Scope Focus Backward |
将焦点移动到您在此操作中设置的焦点范围节点内的反向下一个可聚焦节点。 |
Try Set Focus |
将焦点设置到您在此操作中设置的节点。 |
要了解使用焦点操作,请参阅 使用焦点。
一般动作¶
使用常规操作基于用户输入创建交互。
名称 (Name) |
描述 (Description) |
|---|---|
Move Focus |
将焦点移动到您在操作中设置的焦点链方向上的下一个可聚焦节点。 |
Run Lua Script |
执行您在操作中的 Lua Script 属性中设置的 Lua 脚本。请参阅 使用 Lua、教程:Kanzi Engine Lua API 基本使用 和 Kanzi Lua API 参考。 |
Set Property |
设置您在操作中设置的属性的值。 |
Try Set Focus |
将焦点设置到您在操作中设置的节点。 |
Write Log |
将消息写入 Log 窗口。请参阅 使用 Write Log 操作。 |
要了解属性和 Log 窗口,请参阅 教程:开始使用 Kanzi Studio。
页面操作¶
使用 Page 操作将应用程序设置为导航到特定的 Page 节点。
名称 (Name) |
描述 (Description) |
|---|---|
Navigate to Page |
导航到您在操作中设置的 Page 节点。 |
Navigate to Parent |
导航到您在操作中设置的 Page 节点的父 Page Host 节点。 |
要了解使用 Page 和 Page Host 节点,请参阅 使用 Page 和 Page Host 节点。
主页面操作 (Page Host actions)¶
使用 Page Host 操作在 Page Host 节点中导航到上一个或下一个 Page 节点。
名称 (Name) |
描述 (Description) |
|---|---|
Navigate to Next |
导航到您在操作中设置的 Page Host 节点中的下一个 Page 节点。 |
Navigate to Previous |
导航到您在操作中设置的 Page Host 节点中的下一个 Page 节点。 |
要了解使用 Page 和 Page Host 节点,请参阅 使用 Page 和 Page Host 节点。
预设视图操作 (Prefab View actions)¶
使用 Prefab View 操作从预设中异步加载资源到您的 Kanzi 应用程序中。
名称 (Name) |
描述 (Description) |
|---|---|
Start Asynchronous Load |
开始异步加载您在操作中设置的预设中的资源。 |
要了解有关异步加载预设的信息,请参阅 使用节点预设。
滚动视图动作¶
使用 Scroll View 操作将应用程序设置为在特定方向上或到特定位置滚动 Scroll View 节点或 Grid List Box 节点。
名称 (Name) |
描述 (Description) |
|---|---|
Scroll Down |
将滚动增量设置为向下滚动一步,并开始朝该方向滚动。使用此操作滚动 Scroll View 节点或 Grid List Box 节点。 |
Scroll End |
将滚动增量设置到末端并开始朝该方向滚动。使用此操作滚动 Scroll View 节点或 Grid List Box 节点。 |
Scroll Home |
将滚动增量设置为起始位置,并开始朝该方向滚动。使用此操作滚动 Scroll View 节点或 Grid List Box 节点。 |
Scroll Left |
将滚动增量设置为向左一步,并开始朝该方向滚动。使用此操作滚动 Scroll View 节点或 Grid List Box 节点。 |
Scroll Page Down |
将滚动增量设置为向下翻一页,并开始朝该方向滚动。一页等于此操作目标节点的布局高度。使用此操作滚动 Scroll View 节点或 Grid List Box 节点。 |
Scroll Page Up |
将滚动增量设置为向上一页,并开始朝该方向滚动。一页等于此操作目标节点的布局高度。使用此操作滚动 Scroll View 节点或 Grid List Box 节点。 |
Scroll Right |
将滚动增量设置为向右一步,并开始向该方向滚动。使用此操作滚动 Scroll View 节点或 Grid List Box 节点。 |
Scroll Up |
将滚动增量设置为向上一步,并开始朝该方向滚动。使用此操作滚动 Scroll View 节点或 Grid List Box 节点。 |
Set Scroll |
设置 Scroll View 节点的滚动位置。 |
Set Scroll Target |
设置 Scroll View 节点的滚动目标。 |
要了解使用 Scroll View 节点,请参阅:
要了解使用 Grid List Box 节点,请参阅:
状态机动作¶
使用 State Manager 操作来设置应用程序进入或离开特定状态。
名称 (Name) |
描述 (Description) |
|---|---|
Go to State |
Go to State 操作将状态管理器设置为您在操作中定义的状态。 |
Next State |
将状态管理器设置为您在操作中定义的状态组中的下一个状态。 |
Previous State |
将状态管理器设置为您在操作中定义的状态组中的上一个状态。 |
要了解有关使用状态管理器的信息,请参阅 使用状态机。
主题操作¶
使用 Theme 操作来控制主题。
名称 (Name) |
描述 (Description) |
|---|---|
Activate Theme |
激活您在操作中设置的主题。 |
要了解有关使用主题的信息,请参阅:
Value Accumulator 消息¶
使用 Value Accumulator 来随时间递增属性类型的值。您可以使用 Value Accumulator 消息来控制 Value Accumulators 的播放。
名称 (Name) |
描述 (Description) |
|---|---|
Pause |
暂停 Value Accumulator 应用于其目标属性值的动画。 |
Resume |
恢复由 Value Accumulator 应用于其目标属性值的暂停动画。 |
Start |
启动由 Value Accumulator 应用于其目标属性值的动画。 |
Stop |
启动由 Value Accumulator 应用于其目标属性值的动画,并将目标属性的值重置为其初始值。 |
要了解使用 Value Accumulators,请参阅 增加属性类型的值。。
文本框操作¶
使用 Text Box 操作选择和编辑 Text Box 节点中的文本。
名称 (Name) |
描述 (Description) |
|---|---|
Backspace At Cursor |
使用退格键删除字符。 例如,在使用从左到右书写的文本中,此操作会删除光标左侧的字符。 |
Backspace Word At Cursor |
使用退格键删除直到下一个单词边界的字符。 例如:在使用从左到右书写的文本中,此操作会删除光标位置与光标左侧最近的单词边界之间的字符。 |
Clear Selection |
清除当前文本选择。 |
Cancel Text Composition |
丢弃用户在输入法编辑器 (IME) 中生成的组合文本。 此操作仅在 Text Box 节点处于编辑状态时有效。 |
Commit Composition Text |
提交用户在输入法编辑器 (IME) 中生成的组合文本。 此操作仅在 Text Box 节点处于编辑状态时有效。 |
Delete At Cursor |
使用 delete 删除一个字符。 例如:在使用从左到右书写的文本中,此操作会删除光标右侧的字符。 |
Delete Selection |
删除选定的文本。 |
Delete Text |
删除您在操作中使用 Start Position 和 End Position 属性设置的字符索引之间的文本。 |
Delete Word At Cursor |
使用 delete 删除直到下一个单词边界的字符。 例如:在使用从左到右书写的文本中,此操作会删除光标位置与光标右侧最近的单词边界之间的字符。 |
Enter Editing State |
使 Text Box 节点进入编辑状态。 |
Leave Editing State |
使 Text Box 节点退出编辑状态。 |
Insert Text |
在操作中使用 Position 属性设置的字符索引处插入文本。 |
Insert Text At Cursor |
在光标位置插入文本。 在 Insert Text At Cursor 操作中,将 Text 属性的值设置为您要插入的文本。 |
Move Cursor Backward |
将光标向后移动一个字符。 |
Move Cursor Forward |
将光标向前移动一个字符。 |
Move Cursor Home |
将光标移动到文本内容的第一个字符之前。 |
Move Cursor To End |
将光标移动到文本内容的最后一个字符之后。 |
Move Cursor To Next Word |
将光标向前移动到下一个单词边界。 |
Move Cursor To Previous Word |
将光标向后移动到上一个单词边界。 |
Move Selection End Backward |
将标记文本选择结束的句柄向后移动一个字符。 |
Move Selection End Forward |
将标记文本选择结束的句柄向前移动一个字符。 |
Move Selection End One Word Backward |
将标记文本选择结束的句柄向后移动一个单词。 |
Move Selection End One Word Forward |
将标记文本选择结束的句柄向前移动一个单词。 |
Move Selection Start Backward |
将标记文本选择开始的句柄向后移动一个字符。 |
Move Selection Start Forward |
将标记文本选择开始位置的句柄向前移动一个字符。 |
Move Selection Start One Word Backward |
将标记文本选择开始位置的句柄向后移动一个单词。 |
Move Selection Start One Word Forward |
将标记文本选择开始的句柄向前移动一个单词。 |
Select All |
选择 Text Box 节点中的所有文本。 |
Select Text |
选择您在操作中使用 Start Position 和 End Position 属性设置的字符索引之间的文本。 |
Select To End |
从光标位置选择文本直到文本结束。 |
Select To Home |
从文本的开头选择文本直到光标位置。 |
Select Word At Cursor |
选择一个单词。 |
要了解有关使用 Text Box 节点的更多信息,请参阅 使用 Text Box 节点。