ControlEvent 表
ControlEvent 表允许作者指定当用户与 PushButton 控件、CheckBox 控件或 SelectionTree 控件交互时启动的控件事件。 这些控件是用户唯一可以用来启动控制事件的控件。 每个控件都可以发布多个控件事件。 安装程序按照 Ordering 列中指定的顺序启动每个事件。 例如,按钮控件可以发布用于启动到另一个对话框的转换、退出对话框序列以及开始文件安装的事件。
需要注意的例外情况是,每个控件最多可以发布一个 NewDialog 或 SpawnDialog 事件。 如果需要在此表中创作多个 NewDialog 和 SpawnDialog 控件事件,还请在“条件”字段中包含条件语句,以便确保最多发布一个事件。 如果为同一控件选择了多个 NewDialog 和 SpawnDialog 控件事件,则在激活控件时,仅发布 Ordering 列中具有最大值的事件。
ControlEvent 表具有以下列。
列 | 类型 | 密钥 | Nullable |
---|---|---|---|
Dialog_ | Identifier | Y | N |
Control_ | Identifier | Y | N |
事件 | Formatted | Y | N |
参数 | Formatted | Y | N |
条件 | 条件 | Y | Y |
中间件排序 | 整数 | N | Y |
列
-
Dialog_
-
Dialog 表第一列的外部键。 将此字段与 Control_ 字段组合可标识唯一控件。
-
Control_
-
Control 表第二列的外部键。 将此字段与 Dialog_ 字段组合可标识唯一控件。
-
Event
-
一个标识符,用于指定当用户与由 Dialog_ 和 Control_ 指定的控件交互时应该发生的事件类型。 有关可能值的列表,请参阅 ControlEvent 概述。
若要使用控件设置属性,请将 [Property_Name] 放在该字段中并将新值放在参数字段中。 将 { } 放在参数字段中以输入 Null 值。
-
Argument
-
在触发特定事件时用作修饰符的值。
例如,NewDialog ControlEvent 或 SpawnDialog ControlEvent 的参数是对话框的名称,而安装操作的参数是定义安装级别的数字。
-
Condition
-
一个条件语句,用于确定安装程序是否激活 Event 列中的事件。 如果“条件”字段中的条件语句的计算结果为 True,安装程序将触发事件。 因此,请在此列中输入 1,以确保安装程序触发事件。 如果“条件”字段包含计算结果为 False 的语句,则安装程序不会触发事件。 安装程序不会在“条件”字段中触发值为空白的事件,除非控件其他事件的计算结果均不为 True。 如果 Control_ 字段中命名控件的“条件”字段的计算结果均不为 True,则安装程序将触发一个具有空白“条件”字段的事件;如果多个“条件”字段的值都为空白,则将在“排序”字段中触发其中一个具有最大值的事件。 请参阅条件语句语法。
-
Ordering
-
一个整数,用于对绑定到同一控件的多个事件进行排序。 这必须是非负数。 此字段可以留空。
备注
EventMapping 表列出了订阅某个控件事件的控件,并列出了在另一个控件或安装程序发布该事件时要更改的控件属性。
在 Windows XP 或更低版本的操作系统上,用户只能通过与复选框控件或按钮控件交互来发布控件事件。 使用 Windows Server 2003,用户只能通过与复选框控件、SelectionTree 控件和按钮控件交互来发布控件事件。 在 Control_ 字段中列出其他控件不起作用。
验证