大网数据广告活动
安装更新与部署

Dialog Table

· 52CE 我爱测

The Dialog Table contains all the dialogs that appear in the user interface (UI) in both the full and reduced modes.

The Dialog Table contains all the dialogs that appear in the user interface (UI) in both the full and reduced modes.

The Dialog Table has the following columns.

Column Type Key Nullable
Dialog Identifier Y N
HCentering Integer N N
VCentering Integer N N
Width Integer N N
Height Integer N N
Attributes DoubleInteger N Y
Title Formatted N Y
Control_First Identifier N N
Control_Default Identifier N Y
Control_Cancel Identifier N Y

Columns

Dialog

The primary key and name of the dialog box.

HCentering

The horizontal position of the dialog box.

The range is 0 to 100, with 0 at the left edge of the screen and 100 at the right edge.

VCentering

The vertical position of the dialog box.

The range is 0 to 100, with 0 at the top edge of the screen and 100 at the bottom edge.

Width

The width of the rectangular boundary of the dialog box.

This number must be non-negative.

Height

The height of the rectangular boundary of the dialog box.

This number must be non-negative.

Attributes

A 32-bit word that specifies the attribute flags to be applied to this dialog box.

This number must be non-negative. For more information, see Dialog Style Bits.

Title

A localizable text string specifying the title to be displayed in the title bar of the dialog box.

Control_First

An external key to the second column of the Control Table.

Combining this field with the Dialog field specifies a unique control in the Control Table that takes the focus when the dialog box is opened. Typically, this can be an Edit Control, SelectionTree Control, or any other control that can take the focus. If the PushButton Control is the only control present on the dialog box that can take the focus, the PushButton entered in the ControlDefault field must also be entered into the Control First field. This column is ignored in an Error Dialog box.

Because static text cannot take the focus, a Text Control that describes an Edit Control, PathEdit Control, ListView Control, ComboBox Control or VolumeSelectCombo Control must be made the first control in the dialog box to ensure compatibility with screen readers.

Control_Default

An external key to the second column of the Control Table.

Combining this field with the Dialog field specifies the default control that takes focus when the dialog box is opened. Typically, this can be a PushButton Control. If no PushButton Control on the dialog box has the focus, the Return key is equivalent to clicking on the default control. If this column is left blank, then there is no default control. This column is ignored in an Error Dialog box.

Control_Cancel

An external key to the second column of the Control Table.

Combining this field with the Dialog field specifies a control that cancels the installation. This control is coupled to events in the ControlEvent Table used to cancel the installation. Hitting the ESC key or clicking the Close button is equivalent to clicking on the cancel control. This column is ignored in an Error Dialog

box.

The cancel control is hidden during rollback or the removal of backed up files. The internal UI handler hides the control upon receiving a INSTALLMESSAGE_COMMONDATA message.

Remarks

The integer values for width and height are in the Installer Units, not dialog units.

The two centering values are ignored for subsequent dialog boxes in a wizard sequence. Dialog box positions are set by the user or as for the previous dialog box. These dialog box sequences are created by a NewDialog ControlEvent.

Validation

ICE03
ICE06
ICE13
ICE20
ICE23
ICE27
ICE32
ICE44
ICE45
ICE46

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。