“文本框”用户界面对话框

项目
09/04/2008

更新：2007 年 11 月

使用“文本框”对话框，可以在安装过程中向用户显示最多四个文本输入字段，并返回这些字段的内容。有三个“文本框”对话框可用：“文本框 (A)”、“文本框 (B)”和“文本框 (C)”。这三个对话框是相同的；对于每个部署项目，每个对话框只能添加一次。

该对话框包含四个带关联标签和附加标签的文本框以向用户显示信息。这些标签的文本是在设计时在“属性”窗口中指定的。为每个文本框提供了控制可见性、设置默认值和返回值的附加属性。

下图显示了典型的“文本框”对话框，它与安装过程中显示的对话框一样。

“文本框”对话框

部署用户界面初始屏幕

属性

下列属性可用于“文本框”对话框。

属性	说明
BannerBitmap	指定显示在标题区中的位图或 JPEG 图像。上图中显示的是默认位图。有关更多信息，请参见 BannerBitmap 属性。
BannerText	指定显示在标题区中的文本。在上图中，这对应于“这里是标题文本”。
BodyText	指定显示在文本框上的文本。在上图中，这对应于“这里是正文文本”。
Edit1Label	指定显示在第一个文本框上的文本。在上图中，这对应于“第一个输入字段”。
Edit1Property	指定用于检索在第一个文本框中输入的文本的属性名。此属性可在条件中使用。有关更多信息，请参见条件部署。
Edit1Value	指定第一个文本框的初始值（文本）。
Edit1Visible	指定第一个文本框是可见还是隐藏。对于显示一个或多个文本框的对话框，此属性应设置为 true。
Edit2Label	指定显示在第二个文本框上的文本。在上图中，这对应于“第二个输入字段”。
Edit2Property	指定用于检索在第二个文本框中输入的文本的属性名。此属性可在条件中使用。有关更多信息，请参见条件部署。
Edit2Value	指定第二个文本框的初始值（文本）。
Edit2Visible	指定第二个文本框是可见还是隐藏。对于显示两个或更多个文本框的对话框，此属性应设置为 true；对于显示单个文本框的对话框，此属性应设置为 false。
Edit3Label	指定显示在第三个文本框上的文本。在上图中，这对应于“第三个输入字段”。
Edit3Property	指定用于检索在第三个文本框中输入的文本的属性名。此属性可在条件中使用。有关更多信息，请参见条件部署。
Edit3Value	指定第三个文本框的初始值（文本）。
Edit3Visible	指定第三个文本框是可见还是隐藏。对于显示三个或更多个文本框的对话框，此属性应设置为 true；对于显示两个或更少的文本框的对话框，此属性应设置为 false。
Edit4Label	指定显示在第四个文本框上的文本。在上图中，这对应于“第四个输入区域”。
Edit4Property	指定用于检索在第四个文本框中输入的文本的属性名。此属性可在条件中使用。有关更多信息，请参见条件部署。
Edit4Value	指定第四个文本框的初始值（文本）。
Edit4Visible	指定第四个文本框是可见还是隐藏。对于显示四个文本框的对话框，此属性应设置为 true；对于显示三个或更少的文本框的对话框，此属性应设置为 false。

控制“文本框”对话框的外观

有若干个属性控制“文本框”对话框在安装过程中显示给用户的外观。

“BannerBitmap”属性控制对话框右上角所显示的图像。图像的位置和大小是固定的。

提示：

为了保持用户界面的一致性，应当为安装程序中的所有对话框使用同一个图像。
BannerText 属性控制在对话框顶部的标题中显示的文本。位置、大小和字体大小是固定的。文本将换行，但不能多于两行。
“BodyText”属性控制对话框标题部分正下方显示的文本。位置、大小和字体大小是固定的。文本将换行，但不能多于四行。

提示：
为了保持用户界面的一致性，应当为安装程序中的所有对话框使用同一个图像。

“Edit”N“Label”属性控制文本框标签中的文本。位置和字体大小是固定的，而且文本不会换行。

提示：
对于可本地化的对话框，应当为文本扩展留出额外的空间。一种语言的某个词翻译为另一种语言时，长度可能会增加很多，从而导致文本被截断。

用“文本框”对话框属性检索用户信息

在运行包含“文本框”对话框的安装程序时，用户可以在任何可见的文本框中输入信息。随后您可以在安装的其他阶段使用这些信息。

例如，您可以创建一个“文本框”对话框，使用户可以输入要存储在注册表项中的工作组名。在这种情况下，应将“Edit1Label”属性设置为“请输入工作组名”。此外，还应将“Edit2Visible”、“Edit3Visible”和“Edit4Visible”属性设置为 False，因为只需要一个文本框。

如果您认为用户通常将需要使用名为“Default”的工作组，则可以在“Edit1Value”属性中输入“Default”。这将是用户在文本框中看到的第一项。

在注册表中，将工作组名注册表项的“Condition”属性设置为“Edit1Property”属性的值；例如，[EDITA1]。

安装过程中计算 Condition 属性。如果用户输入名称（或接受默认值），该名称将被添加到注册表；如果为空，则不创建任何注册表项。