ControlEvent 表

ControlEvent 表允许作者指定当用户与 PushButton 控件CheckBox 控件SelectionTree 控件交互时启动的控件事件。 这些控件是用户唯一可以用来启动控制事件的控件。 每个控件都可以发布多个控件事件。 安装程序按照 Ordering 列中指定的顺序启动每个事件。 例如,按钮控件可以发布用于启动到另一个对话框的转换、退出对话框序列以及开始文件安装的事件。

需要注意的例外情况是,每个控件最多可以发布一个 NewDialogSpawnDialog 事件。 如果需要在此表中创作多个 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 ControlEventSpawnDialog ControlEvent 的参数是对话框的名称,而安装操作的参数是定义安装级别的数字。

Condition

一个条件语句,用于确定安装程序是否激活 Event 列中的事件。 如果“条件”字段中的条件语句的计算结果为 True,安装程序将触发事件。 因此,请在此列中输入 1,以确保安装程序触发事件。 如果“条件”字段包含计算结果为 False 的语句,则安装程序不会触发事件。 安装程序不会在“条件”字段中触发值为空白的事件,除非控件其他事件的计算结果均不为 True。 如果 Control_ 字段中命名控件的“条件”字段的计算结果均不为 True,则安装程序将触发一个具有空白“条件”字段的事件;如果多个“条件”字段的值都为空白,则将在“排序”字段中触发其中一个具有最大值的事件。 请参阅条件语句语法

Ordering

一个整数,用于对绑定到同一控件的多个事件进行排序。 这必须是非负数。 此字段可以留空。

备注

EventMapping 表列出了订阅某个控件事件的控件,并列出了在另一个控件或安装程序发布该事件时要更改的控件属性。

在 Windows XP 或更低版本的操作系统上,用户只能通过与复选框控件按钮控件交互来发布控件事件。 使用 Windows Server 2003,用户只能通过与复选框控件SelectionTree 控件按钮控件交互来发布控件事件。 在 Control_ 字段中列出其他控件不起作用。

验证

ICE03
ICE06
ICE17
ICE20
ICE32
ICE44
ICE46
ICE79
ICE86