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