触发器参考¶
您可以在这里找到能在 Kanzi Studio 中使用的触发器的参考。要了解有关触发器的更多信息，请参阅 使用触发器。
活动触发器¶
您可以在 Kanzi Studio 中使用 Activity 触发器与 Activity 节点配合，以在 Activity 状态发生变化时做出反应。例如，您可以设置应用程序在某个 Activity 被激活时进入特定状态。
名称 (Name) |
描述 (Description) |
|---|---|
Activated |
当活动被激活时，Activated 触发器被触发。 |
Activating |
当活动处于激活状态时，Activating 触发器被触发。 |
Deactivated |
当一个活动被停用时，Deactivated 触发器被触发。 |
Deactivating |
当活动处于停用状态时，Deactivating 触发器被触发。 |
Status Changed |
当一个活动的 Activity Status 属性的值发生变化时，Status Changed 触发器被触发。 |
要详细了解使用 Activities 和 Activity Hosts 的信息，请参阅：
Activity Host 触发器¶
您可以在 Kanzi Studio 中使用 Activity Host 触发器与 Activity Hosts 配合使用，以便在一个 Activity 的预设附加到节点树时做出反应。例如，您可以设置应用程序在某个特定的 Activity Host 将其特定子 Activity 的预设附加到节点树时进入特定状态。
名称 (Name) |
描述 (Description) |
|---|---|
Activity Prefab Attached |
当活动主机附加被激活的活动的预设时，Activity Prefab Attached 触发器被触发。 |
Activity Prefab Detached |
当活动主机分离被停用的活动的预设时，Activity Prefab Detached 触发器被触发。 |
要详细了解使用 Activities 和 Activity Hosts 的信息，请参阅：
动画触发器¶
您可以将动画触发器与动画一起使用。例如，您可以设置应用程序在动画播放完成时导航到 Page 或进入某个状态。
名称 (Name) |
描述 (Description) |
|---|---|
Completed |
Completed 触发器拦截 Animation Player 在播放动画到末尾时发送的消息。 |
Started |
Started 触发器拦截 Animation Player 在开始播放动画时发送的消息。 |
Stopped |
Stopped 触发器拦截 Animation Player 在停止动画播放时发送的消息。 |
要详细了解有关创建关键帧动画的信息，请参阅：
要了解有关使用 Property Driven Animation Player 的更多信息，请参阅 创建属性驱动的动画。
焦点触发器¶
您可以使用焦点触发器来处理应用程序中 UI 元素接收焦点的方式。例如，您可以设置当用户打开该覆盖层时，覆盖层对用户输入的反应方式。
名称 (Name) |
描述 (Description) |
|---|---|
About To Gain Focus |
About To Gain Focus 触发器在您添加此触发器的节点获得焦点之前被触发。 |
About To Lose Focus |
在您添加此触发器的节点失去焦点之前，About To Lose Focus 触发器被触发。 |
Focus Entered Focus Scope |
当该焦点范围内的节点获得焦点时，Focus Entered Focus Scope 触发器被设置为焦点范围节点。 |
Focus Gained |
当您将此触发器添加到的节点获得焦点时，Focus Gained 触发器被触发。 |
Focus Left Focus Scope |
当该焦点范围内的节点失去焦点时，Focus Left Focus Scope 触发器被设置为焦点范围节点。 |
Focus Lost |
当您添加此触发器的节点失去焦点时，Focus Lost 触发器被触发。 |
Input Outside Overlay |
当输入发生在该覆盖之外时，Input Outside Overlay 触发器被设置为最前面的覆盖焦点范围。 |
Overlay Brought To Front |
当一个覆盖焦点范围被带到前面以便该范围接收焦点时，Overlay Brought To Front 触发器被触发。 |
Overlay Gained Focus |
当该叠加层中的一个节点获得焦点时，Overlay Gained Focus 触发器被设置为叠加层焦点范围节点。 |
Overlay Lost Focus |
当该叠加层中的一个节点失去焦点时，Overlay Lost Focus 触发器被设置为叠加层焦点范围节点。 |
Overlay Sent To Back |
当一个覆盖焦点范围被发送到后面以使该范围失去焦点时，Overlay Sent To Back 触发器被触发。 |
要详细了解使用焦点触发器的信息，请参阅 使用焦点。
一般触发器¶
您可以在 Kanzi Studio 中使用通用触发器与任何节点一起使用，以在节点附加到节点树时、属性值更改时或在特定时间间隔做出反应。
名称 (Name) |
描述 (Description) |
|---|---|
Data Trigger |
Data Trigger 监控属性和数据源值的变化。使用 Data Trigger 将目标节点的属性值应用于 Apply Property Action，或使用 Apply Activation Action 激活 Activity 节点。要了解有关数据触发器的更多信息，请参阅 数据触发器 和 使用 Apply Activation Action 激活活动。 |
On Attached |
当 Kanzi 将节点附加到节点树时，On Attached 触发器被触发。 |
On Property Change |
当设置的属性值更改时，On Property Change 触发器被触发。 |
On Timer |
On Timer 触发器在您在触发器中设置的时间间隔之间被触发。 |
输入操控器触发器¶
您可以使用输入操控器触发器来处理用户输入，例如手势和触摸事件。使用输入操控器触发器将用户输入绑定到UI组件或应用程序功能。
只有启用了 Hit Testable 属性的节点才能接收输入。请参阅 为节点启用点击手势。
要详细了解输入操纵器触发器，请参阅 处理用户输入。
Click Manipulator 触发器¶
使用 Click Manipulator 触发器对点击手势做出反应。例如，您可以在用户点击该节点时更改节点的外观。
默认情况下，您不能将 Click Manipulator 触发器与处理输入的节点一起使用，例如 Button 和 Toggle Button 节点。
名称 (Name) |
描述 (Description) |
|---|---|
Click |
当用户在指针仍在节点区域内时按下并释放节点，并且 Kanzi 未识别到其他手势时，Click 触发器被激活。 |
Begin |
当用户按下节点时，Begin 触发器被激活。 |
Cancel |
Cancel 触发器已激活：
|
Enter |
Enter 触发器已触发：
|
Leave |
Leave 触发器已关闭：
|
要详细了解有关使用 Click Manipulator 的信息，请参阅 使用 Click Manipulator。
Drag-And-Drop Manipulator 触发器¶
使用 Drag-And-Drop Manipulator 触发器对拖放手势做出反应。例如，您可以在用户拖放该节点时设置节点的外观。
名称 (Name) |
描述 (Description) |
|---|---|
Drag and Drop Canceled |
当在拖放手势期间焦点移出节点时，Drag and Drop Canceled 触发器被触发。 |
Drag and Drop Finished |
当用户通过抬起手指或释放鼠标按钮结束拖放手势时，Drag and Drop Finished 触发器被激活。 |
Drag and Drop Moved |
当用户使用拖放手势拖动节点时，Drag and Drop Moved 触发器被触发。 |
Drag and Drop Started |
当用户长时间按住节点以便输入操控器识别拖放手势时，Drag and Drop Started 触发器被激活。 |
要详细了解使用 Drag-And-Drop Manipulator 的信息，请参阅：
Key Manipulator 触发器¶
您可以使用 Key Manipulator 触发器与键盘进行交互。例如，您可以将应用程序设置为在用户按下键盘上的特定键时导航到 Page 节点或将焦点设置到某个节点。
名称 (Name) |
描述 (Description) |
|---|---|
Key Canceled |
当用户取消按键手势时，Key Canceled 触发器被激活。 |
Key Pressed |
当用户按下键盘上的特定键时，Key Pressed 触发器被激活。 |
Key Released |
当用户释放键盘上的特定键时，Key Released 触发器被激活。 |
要详细了解有关使用 Key Manipulator 触发器的信息，请参阅 使用 Key Manipulator。
Long-Press Manipulator 触发器¶
使用 Long-Press Manipulator 触发器来响应长按手势。例如，您可以在用户点击并按住该节点的时间达到该触发器中设置的时间时，更改节点的外观。
默认情况下，您不能将 Long-Press Manipulator 触发器与处理输入的节点一起使用，例如 Button 和 Toggle Button 节点。
名称 (Name) |
描述 (Description) |
|---|---|
Long Press |
当用户在节点区域按下并按住节点 500 毫秒或该节点中 Long-Press Manipulator 的 Long Press Duration 属性设置的毫秒数时，Long Press 触发器被触发。 |
Long Press Cancel |
当在长按手势期间焦点移出节点时，Long Press Cancel 触发器被触发。 |
要详细了解有关使用 Long-Press Manipulator 的信息，请参阅：
Multi-Click Manipulator 触发器¶
使用 Multi-Click Manipulator 触发器来响应多次点击手势。例如，您可以在用户连续多次点击某个节点时更改该节点的外观。
默认情况下，您不能将 Multi-Click Manipulator 触发器与处理输入的节点一起使用，例如 Button 和 Toggle Button 节点。
名称 (Name) |
描述 (Description) |
|---|---|
Intermediate Click |
当用户在多次点击手势期间在节点区域点击且未达到所需点击次数时，Intermediate Click 触发器被激活。 |
Multi-Click |
当用户在节点区域多次点击时，Multi-Click 触发器被激活。 |
Multi-Click Canceled |
当焦点在多次点击手势期间移开节点时，Multi-Click Canceled 触发器被激活。 |
要详细了解有关使用 Multi-Click Manipulator 的信息，请参阅：
Pan Manipulator 触发器¶
使用 Pan Manipulator 触发器对平移手势做出反应。例如，您可以在用户平移该节点时设置节点的外观。
名称 (Name) |
描述 (Description) |
|---|---|
Pan Canceled |
当在平移手势期间焦点移出节点时，Pan Canceled 触发器被激活。 |
Pan Entered |
当平移手势进入节点时，Pan Entered 触发器被激活。 |
Pan Finished |
当用户通过释放鼠标按钮结束平移手势时，Pan Finished 触发器被激活。 |
Pan Left |
当平移手势离开节点时，Pan Left 触发器被触发。 |
Pan Moved |
当用户使用平移手势移动节点时，Pan Moved 触发器被激活。 |
Pan Started |
当用户点击一个节点但尚未拖动该节点时，Pan Started 触发器被激活。 |
要详细了解有关使用 Pan Manipulator 的信息，请参阅：
Pinch Manipulator 触发器¶
使用 Pinch Manipulator 触发器对捏合手势做出反应。例如，您可以在用户使用捏合手势缩放和旋转节点时设置节点的外观。
名称 (Name) |
描述 (Description) |
|---|---|
Pinch Canceled |
当在捏合手势期间焦点移开节点时，Pinch Canceled 触发器被触发。 |
Pinch Finished |
当用户通过抬起手指结束捏合手势时，Pinch Finished 触发器被触发。 |
Pinch Moved |
当用户使用捏合手势缩放或旋转节点时，Pinch Moved 触发器被激活。 |
Pinch Started |
当用户用两根手指触摸节点时，Pinch Started 触发器被激活。 |
要详细了解有关使用 Pinch Manipulator 的信息，请参阅：
List Box 触发器¶
您可以将列表框触发器与 List Box 节点一起使用。例如，您可以设置应用程序在用户选择 List Box 节点中的某个项目时导航到 Page。
名称 (Name) |
描述 (Description) |
|---|---|
List Box: Item Hidden |
当列表框节点中的项目从工作内存中卸载时，List Box: Item Hidden 触发器被触发。 要设置您想要一次加载多少个项到工作内存，使用 Keep Alive Item Count 属性。 |
List Box: Item Selected |
当用户在列表框中选择一个项目时，List Box: Item Selected 触发器被激活。 |
List Box: Item Visible |
当列表框中的一个项目被创建并加载到工作内存时，List Box: Item Visible 触发器被触发。 要设置您想要一次加载多少个项到工作内存，使用 Keep Alive Item Count 属性。 |
List Box: Scroll Finished |
当列表框滚动结束时，List Box: Scroll Finished 触发器被触发。 |
List Box: Scroll Started |
当列表框开始滚动时，List Box: Scroll Started 触发器被激活。 |
List Box: Scrolled |
每当列表框滚动时，List Box: Scrolled 触发器都会被设置。 |
List Box: Target Changed |
当列表框的滚动目标更改时，List Box: Target Changed 触发器被激活。 例如，当用户选择列表框项时，滚动目标会发生变化，并且列表框会滚动以将该项移至列表框区域的中心。 |
List Box: User Scroll Finished |
当用户停止滚动列表框时，List Box: User Scroll Finished 触发器被激活。 |
List Box: User Scroll Started |
当用户开始滚动列表框时，List Box: User Scroll Started 触发器被激活。 |
要详细了解有关使用 List Box 节点的信息，请参阅：
关于如何使用 List Box 节点的示例，请参阅：
Page Host 触发器¶
使用 Page Host 触发器与 Page Host 节点。例如，您可以设置应用程序在 Page Host 节点开始导航到 Page 时进入某个状态。
名称 (Name) |
描述 (Description) |
|---|---|
Page Navigation Finished |
当 Page Host 节点完成导航到页面时，Page Navigation Finished 触发器被触发。 |
Page Navigation Started |
当 Page Host 开始导航到页面时，Page Navigation Started 触发器被激活。 |
要详细了解使用 Page 和 Page Host 节点的信息，请参阅：
Page 触发器¶
使用 Page 触发器与 Page 节点。例如，您可以设置应用程序在激活 Page 节点时将焦点设置到某个节点。
名称 (Name) |
描述 (Description) |
|---|---|
Page Activated |
当 Page 或 Page Host 节点变为活动状态时，Page Activated 触发器被激活。 |
Page Deactivated |
当 Page 或 Page Host 节点变为非活动状态时，Page Deactivated 触发器被触发。 |
要详细了解使用 Page 和 Page Host 节点的信息，请参阅：
预设件触发器¶
您可以将预设触发器与预设件一起使用。您可以使用 Prefab View 节点从项目中的预设件异步加载资源。
名称 (Name) |
描述 (Description) |
|---|---|
Asynchronous Load Completed |
当从预设异步加载资源完成时，Asynchronous Load Completed 触发器被触发。 |
要详细了解有关异步加载预设件的信息，请参阅 使用节点预设。
属性目标插值器触发器 (Property Target Interpolator Triggers)¶
名称 (Name) |
描述 (Description) |
|---|---|
Easing Interpolation Completed |
Easing Interpolation Completed 触发器拦截 Property Target Easing Interpolator 在完成插值其插值的属性值时发送的消息。 请参阅 获取关于完成缓动插值的信息。 |
Interpolation Completed |
Interpolation Completed 触发器拦截 Property Target Interpolator 在完成插值其插值的属性值时发送的消息。 请参阅 获取关于插值完成的信息。 |
要详细了解使用 Property Target Interpolator，请参阅：
要了解有关使用 Property Target Easing Interpolator 的更多信息，请参阅 使用缓动函数插值属性值。
范围触发器¶
您可以将范围触发器与使用范围属性的组件一起使用。 例如，您可以将应用程序设置为在用户更改滑块的值时触发一个动作。
名称 (Name) |
描述 (Description) |
|---|---|
Value Change Finished |
当范围值更改完成时，Value Change Finished 触发器被触发。 |
Value Change Started |
当范围值开始变化时，Value Change Started 触发器被激活。 |
Value Changed |
当范围值更改时，Value Changed 触发器被触发。 |
Scroll View 触发器¶
您可以将 Scroll View 触发器与 Scroll View 节点一起使用。例如，您可以设置应用程序在用户开始滚动或停止滚动滚动视图时进入某个状态或更改属性的值。
名称 (Name) |
描述 (Description) |
|---|---|
Scroll Ended |
当滚动视图的滚动位置改变完成时，Scroll Ended 触发器被触发。 |
Scroll Started |
当滚动视图的滚动位置开始变化时，Scroll Started 触发器被触发。 |
Scroll Zoomed |
当滚动视图的缩放级别更改时，Scroll Zoomed 触发器被触发。 |
Scrolled |
当滚动视图的滚动位置发生变化时，Scrolled 触发器被激活。 |
Snap Request |
当滚动视图从其托管组件请求捕捉目标时，Snap Request 触发器被触发。 |
User Scroll Ended |
当用户停止滚动滚动视图时，User Scroll Ended 触发器被激活。 |
User Scroll Started |
当用户开始滚动滚动视图时，User Scroll Started 触发器被激活。 |
要详细了解有关使用 Scroll View 节点的信息，请参阅：
有关如何使用 Scroll View 节点的示例，请参阅 滚动视图示例。
状态机触发器¶
您可以将 State Manager 触发器与 State Managers 一起使用。例如，您可以设置应用程序在 state manager 进入某个状态时播放动画。
名称 (Name) |
描述 (Description) |
|---|---|
Entered State |
当状态管理器进入某个状态时，Entered State 触发器被激活。 |
Left State |
当状态管理器离开一个状态时，Left State 触发器被触发。 |
Transition Finished |
当状态管理器完成状态转换时，Transition Finished 触发器被触发。 |
Transition Started |
当状态管理器开始状态转换时，Transition Started 触发器被激活。 |
要详细了解有关使用状态机的信息，请参阅 使用状态机。
要了解有关 Entered State 和 Left State 触发器的更多信息，请参阅 节点进入或离开某个状态时的反应。
Text Box 触发器¶
您可以将 Text Box 触发器与 Text Box 节点一起使用。例如，您可以在用户开始编辑该节点中的文本时设置 Text Box 节点的外观。
名称 (Name) |
描述 (Description) |
|---|---|
Composition Text Changed |
当文本输入操控器更新用户在输入法编辑器 (IME) 中输入的文本时，Composition Text Changed 触发器被激活。 |
Composition Text Committed |
Composition Text Committed 触发器已关闭：
|
Text Composition Canceled |
Text Composition Canceled 触发器已触发：
|
Cursor Moved |
当用户在 Text Box 节点中移动光标时，Cursor Moved 触发器被激活。 |
Editing Finished |
当用户修改文本内容后，Text Box 节点离开编辑状态时，Editing Finished 触发器被触发。 当您在 Text Box 节点中将 Edit Mode 属性设置为 Triggered 时，您可以使用 Leave Editing State 操作来触发此触发器。 |
Editing Started |
当用户开始在 Text Box 节点中编辑文本时，Editing Started 触发器被激活。 当您在 Text Box 节点中将 Edit Mode 属性设置为 Triggered 时，您可以使用 Enter Editing State 操作来触发此触发器。 |
Entered Editing State |
当 Text Box 节点进入编辑状态时，Entered Editing State 触发器被激活。 |
Left Editing State |
当 Text Box 节点离开编辑状态时，Left Editing State 触发器被触发。 |
Input Method Action |
当用户在编辑 Text Box 节点中的文本时，点击屏幕键盘上的操作按钮会触发 Input Method Action。 |
Input Method Available |
当输入方法可用于 Text Box 节点时，Input Method Available 触发器被激活。 例如，当屏幕上出现时，屏幕键盘将可用。 |
Input Method Unavailable |
当用于在 Text Box 节点中撰写文本的输入法不可用时，Input Method Unavailable 触发器被激活。 例如，当用户隐藏屏幕键盘时，屏幕键盘将不可用。 |
Selection Changed |
当用户修改 Text Box 节点中的文本选择时，Selection Changed 触发器被触发。 |
Selection Cleared |
当用户取消选择 Text Box 节点中的文本时，Selection Cleared 触发器被触发。 |
Selection Started |
当用户开始在 Text Box 节点中选择文本时，Selection Started 触发器被激活。 |
Text Changed |
当用户修改 Text Box 节点中的文本时，Text Changed 触发器被激活。 |
要了解有关使用 Text Box 节点的更多信息，请参阅 使用 Text Box 节点。